Difference between revisions of "PHP Native API"

From ScarletDME
Jump to navigation Jump to search
(syntax update)
(Added howto)
Line 10: Line 10:
 
*[[User:Diccon|Diccon]] 18:41, 16 February 2009 (UTC) '''Solved''' Fixed this, not 100% sure what was really happening, but i rewrote the way the login packet is constructed, to make it clearer. This fixed it. Go, Play!
 
*[[User:Diccon|Diccon]] 18:41, 16 February 2009 (UTC) '''Solved''' Fixed this, not 100% sure what was really happening, but i rewrote the way the login packet is constructed, to make it clearer. This fixed it. Go, Play!
 
*[[User:Diccon|Diccon]] 19:36, 27 January 2009 (UTC) <strike>'''Warning''' Active bug found, i believe username padding is not working, some odd length usernames may cause a QMERROR 3000 for line 902, when trying to write to $LOGINS. I'm working on it.</strike>
 
*[[User:Diccon|Diccon]] 19:36, 27 January 2009 (UTC) <strike>'''Warning''' Active bug found, i believe username padding is not working, some odd length usernames may cause a QMERROR 3000 for line 902, when trying to write to $LOGINS. I'm working on it.</strike>
 +
 +
==How to use==
 +
[[#Download|Download]] from the SVN from below.
 +
 +
Place this file in the same directory as the file that intends to use it, or place it in the library path for your PHP configuration.
 +
 +
In your php code Enter the following line at the top
 +
  include "PHPQMLib.php"
 +
 +
The first you need to call the connect function, something like this;
 +
  qmconnect("my.qm.server.com", "4243", "testuser", "testpass", "QMTESTACCOUNT");
 +
or
 +
  qmconnect("192.168.1.1", "4243", "testuser", "testpass", "QMTESTACC");
 +
 +
You can now use the variety of PHPQM functions like qmread(),
 +
qmdelete(), etc as you wish.
 +
When you are done, for tidyness issue a;
 +
  qmdisconnect();
 +
command, tidlying closing the socket.
 +
 +
Each page/script will need to (re)connect. Connection persistance and pooling is
 +
a bit bigger than this simple lib for now.
 +
 +
Check out qmLastClause() QMPHPClient function to cater for commands
 +
hitting ELSE, LOCKED, etc conditions
 +
 +
Generally you can follow the QMClient docs in terms of server functionality.
 +
Using the below defines() as what is and is not implimented.
 +
Better PHP specific docs will be written later, when we go Beta
  
 
==Supported Features==
 
==Supported Features==

Revision as of 15:37, 9 March 2009

The PHP native API uses a socket connection to directly connect to an open and functioning QM API socket.

This single PHP script file can be dropped in on any PHP compatible web server and allow developer to use a series of function calls to access a QM Database with all the functionality that the QMClient API allows.

It is currently in the developing Alpha stages:

News

  • Diccon 15:27, 9 March 2009 (UTC) Conditional Handling code is in, needs proper testing. Now have 34/46 command done, QMCall and a few others will be last because they take a bit of time/effort.
  • Diccon 18:41, 16 February 2009 (UTC) Solved Fixed this, not 100% sure what was really happening, but i rewrote the way the login packet is constructed, to make it clearer. This fixed it. Go, Play!
  • Diccon 19:36, 27 January 2009 (UTC) Warning Active bug found, i believe username padding is not working, some odd length usernames may cause a QMERROR 3000 for line 902, when trying to write to $LOGINS. I'm working on it.

How to use

Download from the SVN from below.

Place this file in the same directory as the file that intends to use it, or place it in the library path for your PHP configuration.

In your php code Enter the following line at the top

 include "PHPQMLib.php"

The first you need to call the connect function, something like this;

 qmconnect("my.qm.server.com", "4243", "testuser", "testpass", "QMTESTACCOUNT");

or

 qmconnect("192.168.1.1", "4243", "testuser", "testpass", "QMTESTACC");

You can now use the variety of PHPQM functions like qmread(), qmdelete(), etc as you wish. When you are done, for tidyness issue a;

 qmdisconnect();

command, tidlying closing the socket.

Each page/script will need to (re)connect. Connection persistance and pooling is a bit bigger than this simple lib for now.

Check out qmLastClause() QMPHPClient function to cater for commands hitting ELSE, LOCKED, etc conditions

Generally you can follow the QMClient docs in terms of server functionality. Using the below defines() as what is and is not implimented. Better PHP specific docs will be written later, when we go Beta

Supported Features

QMPHPClient supports (24/46);

  • Qm Quit
  • GetError
  • Set account
  • Open
  • Close
  • Read
  • ReadL (Untested)
  • ReadLW (Untested/partial)
  • ReadU (Untested)
  • ReadUL(Untested/partial)
  • Select
  • ReadNext
  • ClearSelect
  • ReadList
  • Release
  • Write
  • WriteU
  • Delete
  • DeleteU
  • Execute
  • Respond
  • Logon

Download

If you want a copy, it is released under the LGPL (i.e. can be used within commercial products, but is GPL itself). It is available on the gpl.openqm Subversion repository; (Just click the link people, its not scairy, you just download the file[s])

http://gpl.openqm.com/svn/qmvdb/PHPQMLib/trunk/


Todo Shortlist

  1. Design and handle Conditional Execution, eg ELSE, LOCKED, ERROR, etc
  2. Finish implimenting all simple commands/function (24/46 Done)
  3. Clean up error reporting