An unofficial port of CakePHP 1.3.21 to PHP 7.3+

⚠️ Only use this code, if you have an active CakePHP 1.3 version that you have to port to PHP 8! Otherwise use a current CakePHP version!

1. Make sure your code is PHP 7.3 or newer ready.
2. If you made any changes in the cake-directory, that you want to reapply in this newer PHP version, write them down.
3. Delete your cake-directory.
4. Copy only the cake-directory from this repository to your existing installation.
5. Reapply the changes you wrote down in step 2.
6. Find and fix problems related to the changes described below.

Porting CakePHP to recent PHP versions required the introduction of some breaking changes. Make sure you update your own code according to the following changes:

Two classes had to be renamed:

• The class String has been renamed to CakeString
• The class Object has been renamed to CakeObject

Three class functions had to be renamed:

• JsHelper->value() has been renamed to JsHelper->jsonValue()
• JavascriptHelper->value() has been renamed to JavascriptHelper->jsonValue()
• JsBaseEngineHelper->value() has been renamed to JsBaseEngineHelper->jsonValue()

One file had to be renamed:

• "cake/libs/error.php" has been renamed to "cake/libs/error_handler.php": Change any App::import('Core', 'Error') to App::import('Core', 'ErrorHandler')

Two database drivers had to be removed:

• "mysql" (replace with "mysqli")
• "mssql"

One configuration variable has to be changed:

• "Security.cipherSeed" must be a valid int instead of a string. Make sure, it is small enough to be treated like an int, and not like a float on your system. Otherwise cookies will not be decoded correctly!

The sql-mode ONLY_FULL_GROUP_BY must be disabled. CakePHP creates queries that are incompatible with this mode.

The method lastInsertId() with a second parameter had to be renamed to lastInsertX() due to inheritance

Two new options are possible:

• "Session.cookie_samesite" sets the SameSite-cookie-parameter. Defaults to "Lax". Requires PHP 7.3+ to work.
• "Session.httpOnly" sets the HttpOnly cookie parameter.

The CookieComponent now supports the SameSite-attribute.

In your controller set it like this: $this->Cookie->samesite = "None";

Note: Value of "None" will not be sent to incompatible clients like Safari, in order to keep the intended behavior. Defaults to "Lax".

Core-tests have been ported to PHP 7.3+.

To run any tests, you need a Simpletest 1.0.1 version with PHP 7 support in the vendors-directory.

Notes:

• The original CakePHP 1.3 developers noted, that the core-tests cannot be run all at once. You need to run them individually, or they will fail.
• Some core-tests will fail, if you are not using a dedicated test-database. These are shortcomings in the test-cases.
• Some core-tests fail randomly, that's why they are being excluded from travis.

Please issue a pull request if you want to contribute.