创建Lapis应用程序

jzzlee 发布于2019-07-25 13:52 / 1779人阅读

摘要：使用创建应用程序生成一个新项目如果您尚未阅读，请阅读入门指南，了解有关创建新项目骨架的信息以及，配置和命令的详细信息。是包含应用程序的常规模块。

使用Lua创建Lapis应用程序 生成一个新项目

如果您尚未阅读，请阅读入门指南，了解有关创建新项目骨架的信息以及OpenResty，Nginx配置和lapis命令的详细信息。

您可以在当前目录中通过运行以下命令启动一个新的Lua项目：

lapis new --lua

默认的 nginx.conf 为应用程序读取一个名为 app.lua 的文件。lapis new 提供了一个最基本的结构。

app.lua 是包含应用程序的常规 Lua 模块。你甚至可以像普通 Lua 解释器中的任何其他模块一样加载该模块。它看起来像这样：

-- app.lua
local lapis = require("lapis")
local app = lapis.Application()

app:get("/", function()
  return "Welcome to Lapis " .. require("lapis.version")
end)

return app

启动服务器
lapis server

访问http://localhost:8080以查看该页面

如果要更改端口，我们可以创建一个配置。新建config.lua文件。

在本例中，我们将开发环境中的端口更改为9090：

-- config.lua
local config = require("lapis.config")

config("development", {
  port = 9090
})

您可以在[配置和环境指南]()中阅读有关配置的更多信息。

当运行 lapis server 而没有其他参数时，会自动使用和加载development环境。（而且文件lapis_environment.lua不存在）

Lapis 在配置中使用少量的字段（如 port ），其他字段可以用来存储任何你想要的。例如：

-- config.lua
local config = require("lapis.config")

config("development", {
  greeting = "Hello world"
})

您可以通过调用 get 获取当前配置。它返回一个简单的 Lua 表：

-- app.lua
local lapis = require("lapis")
local config = require("lapis.config").get()

local app = lapis.Application()

app:get("/", function(self)
  return config.greeting .. " from port " .. config.port
end)

return app

创建view

现在我们可以创建基本的页面，我们可能会想要一些更复杂的东西。 Lapis 支持etlua，一种 Lua 模板语言，允许您在 html 和文本中插入 Lua 代码

视图是负责生成 HTML 的文件。通常，您的操作将准备视图的所有数据，然后指示它进行渲染。

默认情况下，Lapis 在 views/ 目录中搜索视图。让我们在那里创建一个新的视图文件index.etlua。我们不会使用任何 etlua 的特殊标记，所以它看起来像一个正常的HTML文件。

Hello world

Welcome to my page

你会注意到，，和标签不在那里。视图通常呈现页面的内部，并且布局负责其周围的东西。我们将进一步看看布局。

现在让我们创建呈现我们的视图的应用程序：

-- app.lua
local lapis = require("lapis")

local app = lapis.Application()
app:enable("etlua")

app:get("/", function(self)
  return { render = "index" }
end)

return app

etlua 在默认情况下不启用，您必须通过调用应用程序实例上的 enable 方法来启用它。

我们使用返回值的 render 参数来指示在呈现页面时要使用的模板。在这种情况下，index 是指名为 views.index 的模块。 etalua 将自己注入到 Lua的require 方法中，因此当模块 views.index 被加载时，会尝试读取和解析文件views/index.etlua 。

运行服务器并在浏览器中导航到它应该可以显示出我们渲染的模板。

使用etlua

etlua 提供了以下标签用于将 Lua 代码注入到模板中：

<％lua_code％> 运行的Lua代码块
<％= lua_expression％> 将表达式的结果写入输出，HTML转义
<％- lua_expression％> 同上，但没有HTML转义

在 [etlua指南]() 中了解有关 etlua 集成的更多信息。
在下面的示例中，我们在操作中分配一些数据，然后在我们的视图中打印出来：

-- app.lua
local lapis = require("lapis")

local app = lapis.Application()
app:enable("etlua")

app:get("/", function(self)
  self.my_favorite_things = {
    "Cats",
    "Horses",
    "Skateboards"
  }

  return { render = "list" }
end)

return app


Here are my favorite things

  <% for i, thing in pairs(my_favorite_things) do %>
    <%= thing %>
  <% end %>

创建布局

布局是一个多带带的共享模板，每个页面都包含的内容。 Lapis 有一个基本的布局让你使用，但你很可能想替换它的东西而自定义。

我们将在 etlua 中编写布局，就像我们的视图。创建 view/layout.etlua：





  
  <%= page_title or "My Page" %>


  Greetings
  <% content_for("inner") %>

content_for 函数是模板中内置的特殊函数，它允许您 将数据从视图发送到布局。 Lapis 将视图的渲染结果放入名为 inner 的内容变量。你会注意到，我们不需要使用任何写入页面的 etlua 标签。这是因为 content_for 有效地将其结果直接放入输出缓冲区。

通常在视图中可用的任何其他变量和帮助函数也可在布局中使用。

现在布局被编写，它可以被分配给应用程序：

local app = lapis.Application()
app:enable("etlua")
app.layout = require "views.layout"

-- the rest of the application...

语法与渲染视图略有不同。不是为 layout 字段分配模板名称，而是分配实际的模板对象。这可以通过引入 views.layout 获得。如上所述，etlua 负责将 .etlua 文件转换为Lua可用的东西。

下一个

请阅读[请求和操作]()指南，了解 Lapis 如何路由 HTTP 请求，并让您对其进行响应。

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/39469.html

lapis入门

摘要：入门是为和编写的框架。使用来安装创建一个应用命令行工具附带了一个命令行工具，可帮助您创建新项目和启动服务器。在生产环境中，应当启用缓存以获得最佳性能。指令指定一个代码块，它将处理与其他不匹配的任何请求。将忽略常规的二进制文件。 lapis入门 Lapis 是为 Lua 和 MoonScript 编写的 Web 框架。 Lapis 很有趣，因为它建立在Nginx 发行的 OpenRest...

endless_road 2019-07-25 13:52 评论0 收藏0
lapis的配置及环境

摘要：配置及环境被设计于依据不同环境载入不同的配置来运行服务器。环境名称仅影响加载的配置。例如，这里有一个的配置块编译时，首先检查环境变量。默认日志记录位置设置为，在默认的配置中指定。配置及环境 Lapis 被设计于依据不同环境载入不同的配置来运行服务器。例如，可能您开发环境的配置设置为本地数据库的URL，禁用代码缓存和单个worker。然后，您生产环境的配置可能设定为远程数据库的 URL...

sarva 2019-07-25 13:53 评论0 收藏0
lapis的异常处理

摘要：的异常处理错误的种类区分两种错误可恢复和不可恢复错误。捕获可恢复的错误帮助程序用于包装一个操作，以便它可以捕获错误并运行错误处理程序。相反，使用协同程序创建一个异常处理系统。 lapis的异常处理错误的种类 Lapis 区分两种错误：可恢复和不可恢复错误。 Lua 的运行时在执行期间抛出的错误或调用错误被认为是不可恢复的。（这也包括 Lua 内置函数 assert ）因为不可恢复...

cucumber 2019-07-25 13:53 评论0 收藏0
lapis请求处理

摘要：处理函数的返回值用于渲染输出。例如，如果不满足某些条件，我们可以取消操作并重定向到另一个页面是处理一个常规动作的返回值，所以同样的事情你可以返回一个动作，可以传递给请求对象每个操作在调用时会请求对象作为其第一个参数传递。 lapis请求处理每个被Lapis处理的HTTP请求在被Nginx处理后都遵循相同的基本流程。第一步是路由。路由是 url 必须匹配的模式。当你定义一个路由时，你也...

Olivia 2019-07-25 13:53 评论0 收藏0
lapis配置之 lua语法

摘要：配置语法配置示例的配置模块提供了对递归合并的支持。例如，我们可以定义一个基本配置，然后覆盖更多具体的配置声明中的一些值这将产生以下两个配置结果默认值省略您可以在相同的配置名称上调用函数多次，每次将传入的表合并到配置中。 Lua 配置语法配置示例 Lapis 的配置模块提供了对递归合并 table 的支持。例如，我们可以定义一个基本配置，然后覆盖更多具体的配置声明中的一些值： --...

BaronZhang 2019-07-25 13:53 评论0 收藏0