PHPackages colopl/colopl\_bc - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. colopl/colopl\_bc ActivePhp-ext[Utility & Helpers](/categories/utility) colopl/colopl\_bc ================= PHP Backwards compatibility library. v13.1.0(4w ago)2015.8k↓37.2%4[1 issues](https://github.com/colopl/php-colopl_bc/issues)[2 PRs](https://github.com/colopl/php-colopl_bc/pulls)BSD-3-ClausePHPPHP ~7.4.0 || ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.1 || ~8.5.0 Since Jun 12Pushed 2d ago2 watchersCompare [ Source](https://github.com/colopl/php-colopl_bc)[ Packagist](https://packagist.org/packages/colopl/colopl_bc)[ RSS](/packages/colopl-colopl-bc/feed)WikiDiscussions main Synced 2d ago READMEChangelog (10)Dependencies (20)Versions (33)Used By (0) colopl\_bc ========== [](#colopl_bc) Provides various compatibility functions required for PHP (temporary) migration. Warning This extension is intended for temporary use only. In other words, code in the production environment should not rely on this implementation as much as possible, and should be gradually phased out when it is safe to do so. Supported Versions ------------------ [](#supported-versions) - Extension: PHP == 7.4 or PHP >= 8.1, 8.5 >= PHP PHP 8.0 is not supported. On PHP 7.4, the Extension provides the PHP 7.4 compatibility namespace as thin wrappers around the native PHP APIs. Usage ----- [](#usage) ### Install [](#install) Extension can be installed in the following steps. Note that the PHP common build tool chain is required. ``` $ cd "ext" $ phpize $ ./configure $ make -j$(nproc) $ make test $ sudo make install ``` Don't forget to enable extension. (Maybe create a `*.ini` file or use `docker-php-ext-enable`) ``` $ echo "extension=colopl_bc" | sudo tee "$(php-config --ini-dir)/10-colopl_bc.ini" $ php -m | grep "colopl_bc" colopl_bc ``` ### Build Ubuntu 22.04 packages [](#build-ubuntu-2204-packages) Ubuntu 22.04 packages are built with standard Debian packaging via `dpkg-buildpackage`, not `checkinstall`. The packaging definitions live alongside each build target under `build/ubuntu2204/debian` and `build/ubuntu2204_sury84/debian`. Build packages for the official Ubuntu 22.04 PHP 8.1 stack: ``` $ docker build -f "build/ubuntu2204/Dockerfile" -t "colopl-bc-u2204-php81" . $ mkdir -p "artifacts" $ docker run --rm -e VERSION="x.y.z" -v "$(pwd)/artifacts:/tmp/artifacts" "colopl-bc-u2204-php81" ``` This target produces `php8.1-colopl-bc_x.y.z__ubuntu22.04_default.deb`. Build packages for Ubuntu 22.04 with the Ondrej Sury PHP 8.4 repository: ``` $ docker build -f "build/ubuntu2204_sury84/Dockerfile" -t "colopl-bc-u2204-php84" . $ mkdir -p "artifacts" $ docker run --rm -e VERSION="x.y.z" -v "$(pwd)/artifacts:/tmp/artifacts" "colopl-bc-u2204-php84" ``` This target produces `php8.4-colopl-bc_x.y.z__ubuntu22.04_sury.deb`. API references -------------- [](#api-references) ### INI directives [](#ini-directives) #### `colopl_bc.php74.compare_mode` (default: `0`) [](#colopl_bcphp74compare_mode-default-0) Sets the compatibility check mode for various comparison operators (e.g. `==`). - 0 (`COLOPL_BC_PHP74_COMPARE_MODE_SILENT`) It does not perform compatibility checks and always uses the results of older behavior. Suitable for use in production environments. - 1 (`COLOPL_BC_PHP74_COMPARE_MODE_DEPRECATED`) Compares the result with the result of a native PHP operator and raises an error equivalent to `E_DEPRECATED` if the results are different. - 2 (`COLOPL_BC_PHP74_COMPARE_MODE_LOG`) Compares the results of native PHP operators and sends a log to the running SAPI if the results are different. #### `colopl_bc.php74.sort_mode` (default: `0`) [](#colopl_bcphp74sort_mode-default-0) Sets the compatibility check mode for various unstable sort algorithms. - 0 (`COLOPL_BC_PHP74_COMPARE_MODE_SILENT`) It does not perform compatibility checks and always uses the results of older behavior. Suitable for use in production environments. - 1 (`COLOPL_BC_PHP74_COMPARE_MODE_DEPRECATED`) Compares the result with the result of a native PHP function and raises an error equivalent to `E_DEPRECATED` if the results are different. - 2 (`COLOPL_BC_PHP74_COMPARE_MODE_LOG`) Compares the results of native PHP functions and sends a log to the running SAPI if the results are different. ### Constants [](#constants) Please check the settings of the corresponding ini directives. - `COLOPL_BC_PHP74_COMPARE_MODE_SILENT` = 0 - `COLOPL_BC_PHP74_COMPARE_MODE_DEPRECATED` = 1 - `COLOPL_BC_PHP75_COMPARE_MODE_LOG` = 2 - `COLOPL_BC_PHP74_SORT_MODE_SILENT` = 0 - `COLOPL_BC_PHP74_SORT_MODE_DEPRECATED` = 1 - `COLOPL_BC_PHP75_SORT_MODE_LOG` = 2 ### Functions [](#functions) - `Colopl\ColoplBc\Php74\ksort()` - `Colopl\ColoplBc\Php74\krsort()` - `Colopl\ColoplBc\Php74\asort()` - `Colopl\ColoplBc\Php74\arsort()` - `Colopl\ColoplBc\Php74\sort()` - `Colopl\ColoplBc\Php74\rsort()` - `Colopl\ColoplBc\Php74\usort()` - `Colopl\ColoplBc\Php74\uasort()` - `Colopl\ColoplBc\Php74\uksort()` - `Colopl\ColoplBc\Php74\array_multisort()` Sorting is performed using the previous unstable sorting algorithm. These compatibilities can also be checked at runtime. See the `colopl_bc.php74.sort_mode` INI directive for details. - `Colopl\ColoplBc\Php74\in_array()` - `Colopl\ColoplBc\Php74\array_search()` - `Colopl\ColoplBc\Php74\array_keys()` These functions use older comparison algorithms than PHP 8.0 for their internal use. These compatibilities can also be checked at runtime. See the `colopl_bc.php74.compare_mode` INI directive for details. - `Colopl\ColoplBc\Php74\eq()` (`==`) - `Colopl\ColoplBc\Php74\neq()` (`!=`) - `Colopl\ColoplBc\Php74\lt()` (`=`) - `Colopl\ColoplBc\Php74\spaceship()` (``) For the corresponding comparison operator, returns results that reproduce the older behavior. These compatibilities can also be checked at runtime. See the `colopl_bc.php74.compare_mode` INI directive for details. - `Colopl\ColoplBc\Php70\srand()` Seed random numbers. Warning `srand()` provided by colopl\_bc are based on the glibc `srand()` / `rand()` algorithm. The results may differ from those of the non glibc environments, e.g. Alpine Linux. - `Colopl\ColoplBc\Php70\rand()` Generate random numbers. Warning `rand()` provided by colopl\_bc are based on the glibc `srand()` / `rand()` algorithm. The results may differ from those of the non glibc environments, e.g. Alpine Linux. - `Colopl\ColoplBc\Php70\getrandmax()` Returns the maximum value that can be returned by a call to `Colopl\ColoplBc\Php70\rand()`. Warning `rand()` provided by colopl\_bc are based on the glibc `srand()` / `rand()` algorithm. The results may differ from those of the non glibc environments, e.g. Alpine Linux. - `Colopl\ColoplBc\Php70\shuffle()` This function shuffles (randomizes the order of the elements in) an array. Warning `shuffle()` use `Colopl\ColoplBc\Php70\rand()` algorithm internally, by colopl\_bc are based on the glibc `srand()` / `rand()` algorithm. The results may differ from those of the non glibc environments, e.g. Alpine Linux. - `Colopl\ColoplBc\Php70\str_shuffle()` str\_shuffle() shuffles a string. One permutation of all possible is created. Warning `str_shuffle()` use `Colopl\ColoplBc\Php70\rand()` algorighm internally, by colopl\_bc are based on the glibc `srand()` / `rand()` algorithm. The results may differ from those of the non glibc environments, e.g. Alpine Linux. - `Colopl\ColoplBc\Php70\array_rand()` Picks one or more random entries out of an array, and returns the key (or keys) of the random entries. Warning `array_rand()` use `Colopl\ColoplBc\Php70\rand()` algorithm internally, by colopl\_bc are based on the glibc `srand()` / `rand()` algorithm. The results may differ from those of the non glibc environments, e.g. Alpine Linux. - `Colopl\ColoplBc\Php70\mt_srand()` Always initialize the state using a **broken** Mersenne twister. - `Colopl\ColoplBc\Php70\mt_rand()` Generate random numbers. Warning This function previously caused undefined behavior and returned different results depending on the CPU architecture. The current behavior is forced to mimic the gcc + amd64 results, and may return different results for PHP in other environments. - `Colopl\ColoplBc\Php70\date_create()` - `Colopl\ColoplBc\Php70\date_create_immutable()` Always instantiate DateTime without milliseconds. License ------- [](#license) This project is licensed under the BSD-3-Clause license. See [LICENSE](LICENSE). ### Health Score 59 — FairBetter than 98% of packages Maintenance96 Actively maintained with recent releases Popularity36 Limited adoption so far Community15 Small or concentrated contributor base Maturity73 Established project with proven stability Bus Factor1 Top contributor holds 65.3% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~57 days Recently: every ~5 days Total 20 Last Release 29d ago Major Versions 10.1.0 → 11.0.02024-03-26 11.1.0 → v12.0.02025-12-03 12.1.0 → v13.0.02026-05-18 PHP version history (5 changes)10.0.0PHP ~7.4.0 || ~8.0.0 || ~8.1.0 10.0.1PHP ~7.4.0 || ~8.0.0 || ~8.1.0 || ~8.2.0 11.0.0PHP ~7.4.0 || ~8.0.0 || ~8.1.0 || ~8.2.0 || ~8.3.0 11.0.3PHP ~7.4.0 || ~8.0.0 || ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.1 v12.0.0PHP ~7.4.0 || ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.1 || ~8.5.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/ec4f701f1c6b107218dbe17f7218ab1b9ff2889e7a543ab4065aba59786ac874?d=identicon)[COLOPL, Inc.](/maintainers/COLOPL,%20Inc.) --- Top Contributors [![zeriyoshi](https://avatars.githubusercontent.com/u/10289597?v=4)](https://github.com/zeriyoshi "zeriyoshi (64 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (22 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (11 commits)")[![siketyan](https://avatars.githubusercontent.com/u/12772118?v=4)](https://github.com/siketyan "siketyan (1 commits)") --- Tags extensionlibraryphpphp7php8 ### Code Quality TestsPHPUnit Static AnalysisPHPStan, Rector Type Coverage Yes ### Embed Badge ![Health badge](/badges/colopl-colopl-bc/health.svg) ``` [![Health](https://phpackages.com/badges/colopl-colopl-bc/health.svg)](https://phpackages.com/packages/colopl-colopl-bc) ``` ### Alternatives [amazon/instantaccess-sdk-php Amazon Instant Access SDK for PHP 1533.5k](/packages/amazon-instantaccess-sdk-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)