Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

PHP 5.2.8 or later is required, along with php5-xsl. No special build options are currently required, other than support for whatever database you plan on using. PHP will work with many different database servers but here we demonstrate how to test that PHP was built with support for MySQL or PostgreSQL, assuming that you have already installed and configured the database server and have created a user named registry_user.

Warning
titlePHP 5.4.0 Enables Strict Error Reporting

As of PHP 5.4.0, PHP ships by default with strict logging enabled. As of CakePHP 2.0.5, this will cause failures during setup. This can be disabled in php.ini by setting

No Format

error_reporting = E_ALL & ~E_STRICT

To test if PHP was built with suppport support for MySQL create the file mysql-test.php with contents

...

Be sure to remove that file after testing so it is not exposed on your web server.

Note
Setup May Throw Errors If PDO Libraries Can't Be Found
Setup May Throw Errors If PDO Libraries Can't Be Found

The database setup step (below) may throw errors like Error: Database connection "Mysql" is missing, or could not be created. if the command line php client can't find the PDO libraries. One way to ensure their availability is to build PHP --with-pdo-mysql (or with the appropriate flag for the database you are using).

You can test for this with php -r 'phpinfo();' | grep pdo:

No Format

$ php -r 'phpinfo();' | grep pdo
pdo_mysql
pdo_mysql.default_socket => /var/lib/mysql/mysql.sock => /var/lib/mysql/mysql.sock
pdo_sqlite
Warning
titlePCRE Bug May Cause Problems

There are known issues with earlier versions of the PCRE library that will cause COmanage Registry to be unable to set up its database tables. Version 6.6 and earlier are known to have problems, while versions 8.02 and later are known to work. You can check the version that PHP was built against by running this command:

php -r 'phpinfo();' | grep PCRE

If you are using an old version of PCRE, you'll first need to install a more recent version. Be sure to configure it with the --enable-utf8 --enable-unicode-properties flags. You'll then need to rebuild PHP against the newer version of the PCRE library.

Alternately, you may be able to rebuild PHP using its own internal copy of PCRE.

...

Set up the database schema.

Code Block
$ cd cake/Consoleapp
$ ./Console/cake database
[...]
Database schema update successful

...

Note
titleDatabase Upgrade Required for 0.5

When upgrading to 0.5 from 0.4 or earlier, a database schema update is required.

Note
titleError: Database connection "Mysql" is missing, or could not be created

This error indicates the command line php utility can't find the appropriate PDO library. Go back and make sure your PHP was built correctly.

For COmanage Registry 0.1 and 0.2

...