Resource Web Access
|
This article needs checking. |
Reason(s): HTTP vars need explanation --jbeta 11:24, 27 October 2007 (CDT) |
The Multi Theft Auto Server provides a web interface that resources can use in a variety of ways. This document's purpose is to explain what these ways are and how to go about using them.
Overview
There are two key parts that make up this system. The first is a standard web server that allows web browsers to request pages and files you have in a resource. The second is a system for allowing web browsers to call functions you have exported from your resource.
Pages
Specifying a file in the meta
You can specify in your resource's meta file that certain files are accessible through the web server. To do this, you add a line:
<html src="filename" />
You can then access this file from your web browser by visiting: http://host:port/resourcename/filename
Binary files
Despite the misleading name, files specified using the html node can be of any type. If they are binary files (like images, zip files) then you need to specify this in the meta file, by adding raw="true" to the html node. This means that the files are not preprocessed before being sent to the web browser.
For example:
<html src="image.gif" raw="true" />
Parsed files
If a file is not specified in the meta file as "raw", then it is passed through a pre-processor before it is returned to the client. This pre-processor works much like PHP or ASP, but uses LUA. You can embed standard MTA scripts within HTML pages, controlling the output. Almost all standard MTA functions work, plus all Template:HTTP functions (such as httpWrite, a function that outputs text to the buffer).
For example:
[html]
<html>
<body>
This resource is called <* httpWrite( getResourceName(getThisResource()) )>
</body>
<html>
Aside from HTTP functions, embedded Lua has access to the following environment variables:
table requestHeaders table form table cookies string hostname string url table querystring