摘要:使用创建应用程序生成一个新项目如果您尚未阅读,请阅读入门指南,了解有关创建新项目骨架的信息以及,配置和命令的详细信息。是包含应用程序的常规模块。
使用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 。
运行服务器并在浏览器中导航到它应该可以显示出我们渲染的模板。
使用etluaetlua 提供了以下标签用于将 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 是为 Lua 和 MoonScript 编写的 Web 框架。 Lapis 很有趣,因为它建立在Nginx 发行的 OpenRest...
摘要:配置及环境被设计于依据不同环境载入不同的配置来运行服务器。环境名称仅影响加载的配置。例如,这里有一个的配置块编译时,首先检查环境变量。默认日志记录位置设置为,在默认的配置中指定。 配置及环境 Lapis 被设计于依据不同环境载入不同的配置来运行服务器。例如,可能您开发环境的配置设置为本地数据库的URL,禁用代码缓存和单个worker。然后,您生产环境的配置可能设定为远程数据库的 URL...
摘要:的异常处理错误的种类区分两种错误可恢复和不可恢复错误。捕获可恢复的错误帮助程序用于包装一个操作,以便它可以捕获错误并运行错误处理程序。相反,使用协同程序创建一个异常处理系统。 lapis的异常处理 错误的种类 Lapis 区分两种错误:可恢复和不可恢复错误。 Lua 的运行时在执行期间抛出的错误或调用错误被认为是不可恢复的。 (这也包括 Lua 内置函数 assert ) 因为不可恢复...
摘要:配置语法配置示例的配置模块提供了对递归合并的支持。例如,我们可以定义一个基本配置,然后覆盖更多具体的配置声明中的一些值这将产生以下两个配置结果默认值省略您可以在相同的配置名称上调用函数多次,每次将传入的表合并到配置中。 Lua 配置语法 配置示例 Lapis 的配置模块提供了对递归合并 table 的支持。 例如,我们可以定义一个基本配置,然后覆盖更多具体的配置声明中的一些值: --...
阅读 2705·2023-04-25 14:21
阅读 1138·2021-11-23 09:51
阅读 3896·2021-09-22 15:43
阅读 588·2019-08-30 15:55
阅读 1525·2019-08-29 11:28
阅读 2376·2019-08-26 11:44
阅读 1646·2019-08-23 18:15
阅读 2835·2019-08-23 16:42