So what about this new kid on the block? If you already have a test server with PHP on it, you can just grab the "Bundle" with the class, examples and docs here: http://www.filemaker.com/developers/resources/php/install.html
FWIW, the package installers do a really nice job of installing PHP 5.12 with no hassle, so if you have been using the default 4x build that came with your Mac, don't hesitate to upgrade with the package installer. The filemaker.php class is compatible with PHP 4x as advertised, but the bundled example php files contain some 5x only functions, making it kind of pointless to try learning with the examples on a 4x install.
Once you have the bundle open, Look for a directory called “apidoc” in the main bundle directory. This has an index file for the html documentation. Tip for those using the package installer. Grab a separate copy of the bundle too. This contains all the portable stuff, including the docs, and examples.
To see what all the l33t haxors are saying, check out these discussions:
The FMI sponsored web forum for filemaker.php. 220.127.116.11
Check out FMForums php.fmforums.com
and filemakerphp.com is dedicated to the subject
If anyone finds more must-see-TV about PHP-for-FileMaker-developers or FileMaker-for-PHP-developers, please do post it.
Okay, so now you have it downloaded and installed... what next?
Being a self-taught “functional” programmer, the object oriented nature of filemaker.php isn’t immediately intuitive for me. If you're anything like me, I suggest you get a dedicated sandbox machine to load a copy of FMSA (subscribing to FSA is by far the cheapest way to get a developer license) and PHP. Your sandbox could be an old PC or a virtual machine. Whatever you choose, get the sample files up and running, then just start goofing around and breaking stuff. A sandbox is the key, because that way you can dump all your hacked up junk periodically and unpack a clean copy of the original bundle. Or if worst comes to worst, you can nuke and pave the whole machine. I find examples to be most useful in seeing how to employ the API. I am working on a full featured example for my Devcon session. Feel free to poke around in my hosted copy of it, but be warned that it is unreleasedeased and under active development. It still needs a few little UI niceties, like a continue link on the success messages and whatnot, or at times might be broken or unavailable altogether (hey, it's in a sandbox). All FileMaker communication is 100% filemaker.php; no FX.php or FMandPHP cheats here ;) Comments welcome.
Side note: I have been saying this for a "long time", and I would still like to see the documentation include a the list of valid properties for a FileMaker object inline with the documentation for setProperty() and getProperty() methods. For now we can work a little harder and see it, but such a list can be built...
(from the documentation, such that it is...)
getPropertiesSo if we write a little script like this:
Get an associative array of property name => property value for all current properties and the values currently in effect. This allows introspection and debugging when necessary.
return: All current properties.
array getProperties ()
Set $prop to a new value for all API calls.
void setProperty (string $prop, string $value)
string $prop: The name of the property
string $value: Its new value.
Returns the currently set value of $prop.
return: The property's current value.
string getProperty (string $prop)
string $prop: The name of the property.
// require the filemaker.php class
// create filemaker.php object
$fm = new FileMaker("FMServer_Sample","localhost","Admin","");
// set an array with the properties of our new $fm object
$properties = $fm->getProperties();
// echo the contents of the $properties array using the preformatted
We get an array like this
Array...but still. Why should we have to work for this? At least they put the username and password back in as arguments to the main class, so there is no longer a need to set those properties if you want to operate on the database with anything other than the values set in config/filemaker-api.php :s
[charset] => utf-8
[locale] => en
[logLevel] => 3
[hostspec] => localhost
[recordClass] => FileMaker_Record
[database] => FMServer_Sample
[username] => Admin
The bummer is, where are the properties like
[debug] => true...well it's a beta, and we have to have something to dream about. It's the FileMaker way :)
[commandurl] => http://Admin:admin@localhost:80/fmi/xml/FMPXMLRESULT.xml?