Multi Theft Auto: Wiki - User contributions [en]

PHP SDK

2007-07-11T15:37:36Z

JackC: /* callFunction */

__NOTOC__
You can access the MTA Web Interface from almost any programming language that can request web pages using HTTP POST and encode and decode [[JSON]].

PHP can do this very easily! This SDK provides one function "callFunction" that will allow you to call any exported script functions on any server that you have access to.

The download below includes two example pages - one that shows a simple scoreboard, the other that shows the automatic handling of element and resource objects.

==Functions==
===callFunction===
'''Syntax:'''
<syntaxhighlight lang="lua">[php]
$mtaSDK = new mta();
$returns[] = $mtaSDK->callFunction( $hostname, $port, "resourceName", "functionName" [,args...] );
</syntaxhighlight>

==Examples==
<syntaxhighlight lang="lua">[php]
include( "mta_sdk.php" );
$mtaSDK = new mta();
$retn = $mtaSDK->callFunction( "bastage.student.utwente.nl", 33004, "echobot", "getThisResource" ); // $retn is an array containing the values the function returned
$resource = $retn[0]; // the first returned value is the resource
$retn = $mtaSDK->callFunction( "bastage.student.utwente.nl", 33004, "echobot", "getResourceName", $resource );
$resourceName = $retn[0]; // contains the name of the resource 'echobot'
</syntaxhighlight>

==Authentication==
If the server you are accessing requires authentication, you must pass the ''http_username'' and ''http_password'' variables to your instantiated instance of the mta() class.

'''Example:'''
<syntaxhighlight lang="lua">[php]
include( "mta_sdk.php" );
$mtaSDK = new mta();
$mtaSDK->http_username = "myUsername";
$mtaSDK->http_password = "myPassword";
$mtaSDK->callFunction( "myServer", 33004, "someResource", "someFunction" );
</syntaxhighlight>

==Caveats==
* This only works with PHP 5.0 and above.
* You cannot currently compare two Resource or Element instances that you expect to be identical - you need to do a "deep compare", comparing either the "id" fields or the "name" fields.

==Download==
*[http://misc.opencoding.net/mta/mtaphpsdk_0.2.zip Download Version 0.2] - Adds authentication support
*[http://misc.opencoding.net/mta/mtaphpsdk_0.1.zip Download Version 0.1] - ''Deprecated - Syntax differs from examples shown above.''

PHP SDK

2007-07-11T00:09:32Z

JackC: Updated details for version 0.2 of the SDK and add information on authentication

__NOTOC__
You can access the MTA Web Interface from almost any programming language that can request web pages using HTTP POST and encode and decode [[JSON]].

PHP can do this very easily! This SDK provides one function "callFunction" that will allow you to call any exported script functions on any server that you have access to.

The download below includes two example pages - one that shows a simple scoreboard, the other that shows the automatic handling of element and resource objects.

==Functions==
===callFunction===
'''Syntax:'''
<syntaxhighlight lang="lua">[php]
$mtaSDK = new mta();
$returns[] = $mtaSDK->callFunction( $hostname, $port, "resourceName", "functionName" [,args...]);
</syntaxhighlight>

==Examples==
<syntaxhighlight lang="lua">[php]
include( "mta_sdk.php" );
$mtaSDK = new mta();
$retn = $mtaSDK->callFunction( "bastage.student.utwente.nl", 33004, "echobot", "getThisResource" ); // $retn is an array containing the values the function returned
$resource = $retn[0]; // the first returned value is the resource
$retn = $mtaSDK->callFunction( "bastage.student.utwente.nl", 33004, "echobot", "getResourceName", $resource );
$resourceName = $retn[0]; // contains the name of the resource 'echobot'
</syntaxhighlight>

==Authentication==
If the server you are accessing requires authentication, you must pass the ''http_username'' and ''http_password'' variables to your instantiated instance of the mta() class.

'''Example:'''
<syntaxhighlight lang="lua">[php]
include( "mta_sdk.php" );
$mtaSDK = new mta();
$mtaSDK->http_username = "myUsername";
$mtaSDK->http_password = "myPassword";
$mtaSDK->callFunction( "myServer", 33004, "someResource", "someFunction" );
</syntaxhighlight>

==Caveats==
* This only works with PHP 5.0 and above.
* You cannot currently compare two Resource or Element instances that you expect to be identical - you need to do a "deep compare", comparing either the "id" fields or the "name" fields.

==Download==
*[http://misc.opencoding.net/mta/mtaphpsdk_0.2.zip Download Version 0.2] - Adds authentication support
*[http://misc.opencoding.net/mta/mtaphpsdk_0.1.zip Download Version 0.1] - ''Deprecated - Syntax differs from examples shown above.''

Talk:MTA Core Specification

2007-02-02T18:23:06Z

JackC:

<h3>2) Database Schema</h3>

<h4>2a) core_registered_servers</h4>
<table border="1">
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
<tr>
<td>owners</td>
<td>text</td>
<td>Comma delimited list of the userid's who own the server</td>
</tr>
</table>

Isn't is better/faster to store these in a separate, indexed table? Comma separated stuff in a database looks a bit dodgy [[User:Harry|Harry]] 07:32, 17 January 2007 (CST)

No [[User:JackC|JackC]]