InSim PHP5-Tutorial - Revision history

Flame CZE at 00:59, 2 December 2023

2023-12-02T00:59:18Z

2010-02-05T14:29:35Z

MSHT

2010-02-05T14:29:22Z

MSHT

2010-02-05T14:27:40Z

float

2010-02-05T14:26:36Z

MSHT

2010-02-05T14:26:15Z

MSHT

2010-02-05T14:26:04Z

Added Example of Pack and Unpack + Added Deprecated Information.

2010-02-05T14:20:25Z

char

2010-02-05T14:19:48Z

Must be null terminated.

2010-02-05T14:15:45Z

The pack type 'v' is more appropriate as it's an unsigned short (16bit) that's in the little endian byte order.

@@ Line 1: / Line 1: @@
 This tutorial will only work if you or your webhoster have PHP version 5.0.0 or higher installed (5.1.x recommended!), because the <tt>stream_socket_*</tt>-functions are not available in PHP 4 and the sockets that can be created in PHP 4 using the <tt>socket_*</tt>-functions can not be run really non-blocking, so you can not prevent errors like timeouts.
 <div style="color: red; font-weight: bold;"><span style="font-size: 20px;">WARNING: This tutorial will only work with the OLD InSim provided up to patch W!</span><br />A new version of this article is expected to come soon.</div>
@@ Line 391: / Line 393: @@
 InSimClose: waiting for connection
 </pre>

←Older revision		Revision as of 14:29, 5 February 2010
Line 113:		Line 113:

	MSHT is a time-information (Minutes Seconds Hundreths Thousandths) and simply consists of 4 byte-type parts.		MSHT is a time-information (Minutes Seconds Hundreths Thousandths) and simply consists of 4 byte-type parts.
−

	<pre>		<pre>

@@ Line 110: / Line 110: @@
 === MSHT ===
-<span style="color: red; font-weight: bold;">Deprecated</span>
+<span style="color: red;"><span style="font-weight: bold;">Deprecated</span> <span style="font-style: italic;">It should be noted that this datatype is no longer used by InSim.</span></span>
 MSHT is a time-information (Minutes Seconds Hundreths Thousandths) and simply consists of 4 byte-type parts.
 <pre>

@@ Line 109: / Line 109: @@
 </pre>
-=== MSHT === - '''Deprecated'''
+=== MSHT ===
 MSHT is a time-information (Minutes Seconds Hundreths Thousandths) and simply consists of 4 byte-type parts.

@@ Line 109: / Line 109: @@
 </pre>
-=== MSHT ===
+=== MSHT === - '''Deprecated'''
 MSHT is a time-information (Minutes Seconds Hundreths Thousandths) and simply consists of 4 byte-type parts.

@@ Line 22: / Line 22: @@
 // Example: InSim.txt says the part "Admin" of the InSimInit packet has the datatype char[16],
 // but the admin-password of your server is only 8 characters long. So we have to str_pad it:
-$adminpw_padded = str_pad($adminpw, 16, "\0");
+$adminpw = str_pad($adminpw, 16, "\0");
 ?>

@@ Line 10: / Line 10: @@
 // if a part of a package has the datatype "char", it is simply plain text,
 // but str_pad() MUST be used to make this part exactly as long as it is told in InSim.txt.
 // char-data must not be longer than it is specified in InSim.txt. If someone would specify
 // an admin-password that is 17 chars long or longer, f.e. $adminpw = "myverylongadminpw";
-// we would have to cut it down to 16 chars BEFORE str_padding it.
+// we would have to cut it down to 15 chars BEFORE str_padding it to 16 (because the 16th place must be the NUL).
 // (logging in to the LfS-Servers InSim-port would work flawlessly because the server
 //  also only allows the admin-pw to be 16 chars long.)
-if (strlen($adminpw) > 16) {
+if (strlen($adminpw) >= 16) {
-   $adminpw = substr($adminpw, 0, 16);
+   $adminpw = substr($adminpw, 0, 15);
+}
 ?>
 </pre>

@@ Line 42: / Line 42: @@
 <?php
 // Parts of Packages that have the datatype "word" are strings/ints in PHP and are converted
 // using pack() and unpack():
-$word_packed = pack("S", $word);
+$word_packed = pack("v", $word);
 // "words" that work properly with unpack must be atleast 2 chars long, so pad it with "\0"
@@ Line 49: / Line 50: @@
    $word_packed = str_pad($word_packed, 2, "\0");
+}
-$temp = unpack("S",$word_packed);
+$temp = unpack("v",$word_packed);
 $word_unpacked = $temp[1];
 ?>