Download the PHP package gilbertsoft/typo3-core-patches without Composer

TYPO3 Core Patches

This package let you easily manage TYPO3 Core patches with Composer based on cweagans/composer-patches which is a dependency of this package and requires to be installed as non-dev dependency for production usage.

Table of contents:

• Installation
  • Prerelease
• Usage
  • Adding a change
  • Updating a change
  • Removing a change
  • Supported change ID formats
• Configuration
  • Branch verification
  • Outdated patch detection
  • CI detection
• Feedback / Bug reports / Contribution
• License

Installation

This package requires Composer 2.0 or higher.

Require this package as normal dependency:

If the package is installed as dev requirement, the patches won't get applied using the install option --no-dev as long as you don't require cweagans/composer-patches as normal dependency.

For Composer 2.2 and later, plug-ins must be explicitly allowed using the following command:

Prerelease

To install a prerelease, run the following command using one of the stability flags dev, alpha, beta or RC:

E.g. this would allow Composer to install beta, RC and stable releases:

Usage

Adding a change

Lookup the change ID at https://forge.typo3.org or https://review.typo3.org and provide it as argument or multiple arguments for multiple changes at once:

This plugin will then properly create patch files for the change and save it to the patch directory which defaults to patches. The patch directory can be changed by the option --patch-dir or with the shortcut -p:

By default changes in tests are exluded. If you also like to include these changes, provide the option --tests or the shortcut -t. This will result in installing the sources instead of the dist packages for the affected packages.

Updating a change

To update the applied patches to the last patch sets from Gerrit just run the following command, which will update all patches:

It is also possible to just update some single patches by providing the change ID as argument or multiple arguments for multiple changes to update at once:

Removing a change

Provide the change ID to remove as argument or multiple arguments for multiple changes to remove at once:

Supported change ID formats

This plugin supports various change-id formats, as described in https://review.typo3.org/Documentation/rest-api-changes.html#change-id.

Additionally, you can also specify the full URL for the change, as shown in the next example:

Configuration

Branch verification

The plugin compares the current installed core version with the target branch of the patch to install and if different, asks for confirmation to anyway try to apply the patch to the different version.

To disabled the branch check for this project, run:

Outdated patch detection

When running composer update or composer install, the plugin detects changes that already exist in the version being installed and suggests removing the related patches. If you run Composer with the --no-interaction option, the patches are always preserved. This can be changed by the config force-tidy-patches see bellow.

Errors may occur if you use the source-dist of packages, which can be solved by adding the config.discard-changes configuration option to your composer.json, see https://getcomposer.org/doc/06-config.md#discard-changes. Run e.g. composer config discard-changes true to add the configuration to your composer.json.

If a CI environment is detected, the detection of merged changes is skipped by default. To change this behavior and enable the detection again, run:

To disable the detection of merged changes completely, run:

CI detection

The plugin tries to detect CI environments and changes its default behavior while running in a CI pipeline. It's possible to override the detection by setting an environment variable:

• Set GS_CI=1 to force CI mode
• Set GS_CI=0 to disable CI mode

Feedback / Bug reports / Contribution

Bug reports, feature requests, pull requests, and any other kind of feedback are welcome in the GitHub repository.

For support questions or other discussions please use the GitHub Discussions or join the dedicated TYPO3 Slack channel.

License

This package is licensed under the MIT License.