<function name="Post" parent="http" type="libraryfunc"> <description> Sends an asynchronous POST request to a HTTP server. HTTP requests returning a status code &gt;= 400 are still considered a success and will call the onSuccess callback. The onFailure callback is usually only called on DNS or TCP errors (e.g. the website is unavailable or the domain does not exist) <note>HTTP-requests to destinations on private networks (such as `192.168.0.1`) won't work.<br/> To enable HTTP-requests to destinations on private networks use <page>Command Line Parameters</page> `-allowlocalhttp`</note>⤶ HTTP requests returning a status code >= `400` are still considered a success and will call the <page text="onSuccess">Structures/HTTPRequest</page> callback. The <page text="onFailure">Structures/HTTPRequest</page> callback is usually only called on DNS or TCP errors (e.g. the website is unavailable or the domain does not exist) <note>HTTP-requests to destinations on private networks (such as `192.168.0.1`) won't work.<br/> To enable HTTP-requests to destinations on private networks use <page>Command Line Parameters</page> `-allowlocalhttp`.</note>⤶ </description> <realm>Shared and Menu</realm> <file line="46-L73">lua/includes/modules/http.lua</file> <args> <arg name="url" type="string">The url to of the website to fetch.</arg> <arg name="parameters" type="table">The post parameters (x-www-form-urlencoded) to be send to the server. `'Keys and values` must'' be strings.</arg> <arg name="onSuccess" type="function" default="nil">The function called on success: function( string responseText, number contentLength, table responseHeaders, number statusCode )</arg> <arg name="onFailure" type="function" default="nil">The function called on failure: function( string errorMessage )</arg> <arg name="headers" type="table" default="{}">KeyValue table for headers</arg>⤶ <arg name="parameters" type="table">The post parameters (x-www-form-urlencoded) to be send to the server. **Keys and values must be strings**.</arg> <arg name="onSuccess" type="function" default="nil">The function called on success: `function( string responseText, number contentLength, table responseHeaders, number statusCode )`.</arg> <arg name="onFailure" type="function" default="nil">The function called on failure: `function( string errorMessage )`.</arg> <arg name="headers" type="table" default="{}">KeyValue table for headers.</arg>⤶ </args> </function> <example> <description> Write a file in PHP, and invoke it from Lua. The output below is written in the file, not in the console. ``` <?php $p = $_POST["p"]; $a = $_POST["a"]; $f = fopen("write.html", "w"); fwrite($f, "This is a test. $p $a\n"); fclose($f); ?> ``` </description> <code> http.Post("http://localhost/post.php", { p = "Gmod", a = "Test" }, function(result) if result then print("Done!") end⤶ end, function(failed) print(failed)⤶ end) http.Post( "http://localhost/post.php", { p = "Gmod", a = "Test" }, ⤶ -- onSuccess function⤶ function( body, length, headers, code ) if body then⤶ print( "Done!" ) end⤶ end,⤶ ⤶ -- onFailure function⤶ function( message )⤶ print( message )⤶ end⤶ ⤶ )⤶ </code> <outputfixedwidth>Fixed width</outputfixedwidth>⤶ <output>This is a test. Gmod Test</output> ⤶ </example></example>