Jackalope Transport library for http://prismic.io DBAL
Implementation of the PHP Content Repository API (PHPCR) using a relational database to persist data.
Jackalope uses the http://prismic.io service for storage.
For the moment, it is less feature complete, performant and robust than Jackalope-Jackrabbit.
Discuss on firstname.lastname@example.org or visit #jackalope on irc.freenode.net
This code is dual licensed under the MIT license and the Apache License Version 2.0. Please see the file LICENSE in this folder.
- php >= 5.3
- One of the following databases, including the PDO extension for it:
- MySQL >= 5.1.5 (we need the ExtractValue function)
The recommended way to install jackalope is through composer. You can of course do without, but then you will need to resolve the dependencies manually.
$ mkdir my-project $ cd my-project $ curl -s http://getcomposer.org/installer | php $ ./composer.phar init $ ./composer.phar require jackalope/jackalope-prismic $ ./composer.phar install
Create a login on http://prismic.io and follow the instructions there.
There are a couple of useful commands to interact with the repository.
To use the console, copy
cli-config.php and configure
the connection parameters.
Then you can run the commands from the jackalope directory with
NOTE: If you are using PHPCR inside of Symfony, the DoctrinePHPCRBundle provides the commands inside the normal Symfony console and you don't need to prepare anything special.
You have many useful commands available from the phpcr-utils. To get a list of all commands, type:
To get more information on a specific command, use the
help command. To learn
more about the
phpcr:workspace:export command for example, you would type:
$ ./bin/jackalope help phpcr:workspace:export
Jackalope relies on autoloading. Namespaces and folders are compliant with
PSR-0. You should use the autoload file generated by composer:
If you want to integrate jackalope into other PSR-0 compliant code and use your
own classloader, find the mapping in
Before you can use jackalope with a database, you need to set the database up. Create a database as described above, then make sure the command line utility is set up (see above "Enable the commands"). Now you can run:
$ bin/jackalope jackalope:init:dbal
Once these steps are done, you can bootstrap the library. A minimalist sample code to get a PHPCR session with the prismic backend:
$uri = 'https://%s.prismic.io/api'; $workspace = 'lesbonneschoses'; // phpcr workspace to use $factory = new \Jackalope\RepositoryFactoryPrismic(); $repository = $factory->getRepository(array('jackalope.prismic_uri' => $uri)); // dummy credentials to comply with the API $credentials = new \PHPCR\SimpleCredentials(null, null); $session = $repository->login($credentials, $workspace);
The entry point is to create the repository factory. The factory specifies the storage backend as well. From this point on, there are no differences in the usage (except for supported features, that is).
// see Bootstrapping for how to get the session. $rootNode = $session->getNode("/");
See PHPCR Tutorial for a more detailed tutorial on how to use the PHPCR API.
Jackalope supports logging, for example to investigate the number and type of queries used. To enable logging, provide a logger instance to the repository factory:
$factory = new \Jackalope\RepositoryFactoryPrismic(); $logger = new Jackalope\Transport\Logging\DebugStack(); $options = array( 'jackalope.uri' => $uri, 'jackalope.logger' => $logger, ); $repository = $factory->getRepository($options); //... // at the end, output debug information var_dump($logger->calls);
Note that when using jackalope in Symfony2, the logger is integrated in the debug toolbar.
See doc/architecture.md for an introduction how Jackalope is built. Have a look at the source files and generate the phpdoc.
Jackalope-prismic is integrated with the phpcr-api-tests suite that tests all PHPCR functionality.
If you want to run the tests, please see the README file in the tests folder.
The best overview of what needs to be done are the skipped API tests. Have a look at ImplementationLoader to see what is currently not working and start hacking :-)
Also have a look at the issue trackers of this project and the base jackalope/jackalope.