php-builder

KO | EN

gitlite — search

#javascript #python #hacktoberfest #typescript #llm #android #machine-learning #deep-learning #linux #macos #awesome #cli #security #mcp

(★ 75)

:elephant: Build PHP 5.6 to 8.6. PHP 8.6 is built nightly

File Explorer

Download Latest Version (.zip)

- - build.yml
  - ci.yml
  - libraries.yml
  - package.yml
- - changelog
  - compat
  - control
- - 5.6
  - 7.0
  - 7.1
  - 7.2
  - 7.3
  - 7.4
  - 8.0
  - 8.1
  - 8.2
  - 8.3
  - 8.4
  - 8.5
  - 8.6
- - 5.6
  - 7.0
  - 7.1
  - 7.2
  - 7.3
  - 7.4
  - 8.0
  - 8.1
  - 8.2
  - 8.3
  - 8.4
  - 8.5
  - 8.6
- - libgd2
  - mpdecimal
  - pcre2
  - pcre3
  - uw-imap
- - amqp.ini
  - apcu.ini
  - ast.ini
  - bcmath.ini
  - bz2.ini
  - calendar.ini
  - ctype.ini
  - curl.ini
  - dba.ini
  - decimal.ini
  - dom.ini
  - ds.ini
  - enchant.ini
  - excimer.ini
  - exif.ini
  - ffi.ini
  - fileinfo.ini
  - ftp.ini
  - gd.ini
  - gearman.ini
  - gettext.ini
  - gmp.ini
  - gnupg.ini
  - grpc.ini
  - http.ini
  - ibm_db2.ini
  - iconv.ini
  - igbinary.ini
  - imagick.ini
  - imap.ini
  - intl.ini
  - json.ini
  - krb5.ini
  - ldap.ini
  - lz4.ini
  - mailparse.ini
  - maxminddb.ini
  - mbstring.ini
  - mcrypt.ini
  - memcache.ini
  - memcached.ini
  - mongo.ini
  - mongodb.ini
  - msgpack.ini
  - mysqli.ini
  - mysqlnd.ini
  - oauth.ini
  - odbc.ini
  - opcache.ini
  - opentelemetry.ini
  - pcov.ini
  - pdo.ini
  - pdo_dblib.ini
  - pdo_firebird.ini
  - pdo_mysql.ini
  - pdo_odbc.ini
  - pdo_pgsql.ini
  - pdo_sqlite.ini
  - pdo_sqlsrv.ini
  - pgsql.ini
  - phalcon.ini
  - phar.ini
  - posix.ini
  - pq.ini
  - propro.ini
  - protobuf.ini
  - pspell.ini
  - psr.ini
  - raphf.ini
  - rdkafka.ini
  - readline.ini
  - redis.ini
  - rrd.ini
  - shmop.ini
  - simplexml.ini
  - smbclient.ini
  - snmp.ini
  - soap.ini
  - sockets.ini
  - solr.ini
  - sqlite3.ini
  - sqlsrv.ini
  - ssh2.ini
  - swoole.ini
  - sysvmsg.ini
  - sysvsem.ini
  - sysvshm.ini
  - tidy.ini
  - tokenizer.ini
  - uopz.ini
  - uploadprogress.ini
  - uuid.ini
  - xdebug.ini
  - xhprof.ini
  - xlswriter.ini
  - xml.ini
  - xmlreader.ini
  - xmlrpc.ini
  - xmlwriter.ini
  - xsl.ini
  - yaml.ini
  - zip.ini
  - zmq.ini
  - zstd.ini
- default_apache
- default_nginx
- optional-extensions
- os_releases.csv
- php-cgi.conf
- php-fpm.conf
- php-fpm.logrotate
- php-fpm.service
- php-fpm.tmpfile
- php.conf
- php.load
- - cleanup.sh
  - extensions.sh
  - package.sh
  - pear.sh
  - php_build.sh
  - strip.sh
  - version.sh
- - build.sh
  - common.sh
  - get-matrix.sh
  - install.sh
- build.sh
- check-php-version.sh
- get-matrix.sh
- get-php-versions.sh
- install-extension.sh
- install-requirements.sh
- install.sh
- patch-extensions.sh
- php-fpm-reopenlogs
- php-fpm.init
- release.sh
- retry.sh
- switch_jit
- switch_sapi
- test_extensions.sh
- test_pecl.sh
- test_sapi.sh
.gitignore
LICENSE
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# PHP Builder

- This projects builds PHP 5.6 and above (including a nightly build from the master branch of PHP) on `Ubuntu` and `Debian`.
- To install PHP, follow the instructions in the [install](#install) section.
- To download a PHP build, refer to the [builds](#Builds) section.

## Contents

- [OS Support](#os-support)
- [Install](#install)
- [Extensions](#extensions)
- [JIT](#jit)
- [SAPI Support](#sapi-support)
- [Builds](#builds)
- [Uninstall](#uninstall)
- [Related Projects](#related-projects)
- [License](#license)
- [Dependencies](#dependencies)

## OS Support

- Ubuntu 22.04 (Jammy) amd64/arm64
- Ubuntu 24.04 (Noble) amd64/arm64
- Ubuntu 26.04 (Resolute) amd64/arm64
- Debian 11 (Bullseye) amd64/arm64
- Debian 12 (Bookworm) amd64/arm64
- Debian 13 (Trixie) amd64/arm64

All other distributions based on the above operating systems will also be supported on best effort basis.

## Install

- Fetch the installer:

```bash
curl -sSLO https://github.com/shivammathur/php-builder/releases/latest/download/install.sh
chmod a+x ./install.sh
```

The installer takes the following options:
```bash
./install.sh <php-version> <release|debug> <nts|zts>
```

The `php-version` is required, and `release` and `nts` are the defaults.

- release: No debugging symbols
- debug: With debugging symbols
- nts: Non Thread Safe
- zts: Thread Safe

### Examples

- To install `PHP 8.4` without debugging symbols and non thread safe:

```bash
./install.sh 8.4
```

- or, to install `PHP 8.4` with debugging symbols and thread safe:

```bash
./install.sh 8.4 debug zts
```

- Finally, test your PHP version:

```bash
php -v
```

**Notes:**

- All PHP versions have the prefix `/usr` and the directory structure will be same as that of the official Debian builds.
- Any pre-existing extensions INI configuration for the PHP version will be removed upon installation.
- The installer will switch to the PHP version you installed.

## Extensions

<ul><li><details>
  <summary>Expand to check the extensions installed along with PHP.</summary>
  <br>

`amqp`, `apcu`, `ast`, `bcmath`, `bz2`, `calendar`, `Core`, `ctype`, `curl`, `date`, `dba`, `dom`, `ds`, `enchant`, `exif`, `FFI`, `fileinfo`, `filter`, `ftp`, `gd`, `gettext`, `gmp`, `hash`, `iconv`, `igbinary`, `imagick`, `imap`, `intl`, `json`, `ldap`, `libxml`, `mbstring`, `memcache`, `memcached`, `mongodb`, `msgpack`, `mysqli`, `mysqlnd`, `odbc`, `openssl`, `pcntl`, `pcov`, `pcre`, `PDO`, `pdo_dblib`, `PDO_Firebird`, `pdo_mysql`, `PDO_ODBC`, `pdo_pgsql`, `pdo_sqlite`, `pdo_sqlsrv`, `pgsql`, `Phar`, `posix`, `pspell`, `readline`, `redis`, `Reflection`, `session`, `shmop`, `SimpleXML`, `soap`, `sockets`, `sodium`, `SPL`, `sqlite3`, `sqlsrv`, `standard`, `sysvmsg`, `sysvsem`, `sysvshm`, `tidy`, `tokenizer`, `xdebug`, `xml`, `xmlreader`, `xmlwriter`, `xsl`, `zip`, `zlib`, `Xdebug`, `Zend OPcache`

</details></li></ul>

- Extension PCOV is disabled by default as Xdebug is enabled.

- You can switch to PCOV by disabling Xdebug using `phpdismod` and enabling it using `phpenmod`.

```bash
phpdismod -v <ALL|php-version> -s <ALL|sapi-name> xdebug
phpenmod -v <ALL|php-version> -s <ALL|sapi-name> pcov
```

- `PECL` is also installed along with PHP, so compatible extensions can also be installed using it. These will be enabled using the `pecl.ini` module which is linked to all SAPIs.

```bash
pecl install <extension>
```

## JIT

PHP 8.0 and above versions have a JIT(Just-In-Time) compiler.

It is disabled by default, and can be enabled by the following steps:

- First, disable Xdebug and PCOV as they are not compatible with JIT.

```bash
phpdismod -v <ALL|php-version> -s <ALL|sapi-name> xdebug pcov
```

- Then enable JIT using the `switch_jit` script for the same PHP versions and SAPIs.

```bash
switch_jit -v <ALL|php-version> -s <ALL|sapi-name> enable -m <jit_mode> -b <jit_buffer_size>
```

If you do not specify `-m` or `-b`, the default for JIT mode is `tracing`, and for JIT buffer size it is `128M`.

- If you get a warning about incompatible extensions, check if you installed any other third-party extensions which are incompatible with JIT.

To disable JIT:

```bash
switch_jit -v <php-version> -s <ALL|sapi-name> disable
```

## SAPI support

These SAPIs are installed by default:

- `apache2-handler`
- `cli`
- `cgi`
- `embed`
- `fpm`
- `phpdbg`

These SAPI:server configurations can be set up with the `switch_sapi` script:

- `apache:apache` (apache2-handler with Apache)
- `fpm:apache` (php-fpm with Apache)
- `cgi:apache` (php-cgi with Apache)
- `fpm:nginx` (php-fpm with Nginx)

```bash
switch_sapi -v <php-version> -s <sapi|sapi:server>
```

**Note:** When you run `switch_sapi`, the servers will have the default document root `/var/www/html`.

## Builds

The following releases have `nts` and `zts` builds for the following PHP versions along with builds with and without debugging symbols.

- [PHP 8.6.0-dev](https://github.com/shivammathur/php-builder/releases/tag/8.6)
- [PHP 8.5.x](https://github.com/shivammathur/php-builder/releases/tag/8.5)
- [PHP 8.4.x](https://github.com/shivammathur/php-builder/releases/tag/8.4)
- [PHP 8.3.x](https://github.com/shivammathur/php-builder/releases/tag/8.3)
- [PHP 8.2.x](https://github.com/shivammathur/php-builder/releases/tag/8.2)
- [PHP 8.1.34](https://github.com/shivammathur/php-builder/releases/tag/8.1)
- [PHP 8.0.30](https://github.com/shivammathur/php-builder/releases/tag/8.0)
- [PHP 7.4.33](https://github.com/shivammathur/php-builder/releases/tag/7.4)
- [PHP 7.3.33](https://github.com/shivammathur/php-builder/releases/tag/7.3)
- [PHP 7.2.34](https://github.com/shivammathur/php-builder/releases/tag/7.2)
- [PHP 7.1.33](https://github.com/shivammathur/php-builder/releases/tag/7.1)
- [PHP 7.0.33](https://github.com/shivammathur/php-builder/releases/tag/7.0)
- [PHP 5.6.40](https://github.com/shivammathur/php-builder/releases/tag/5.6)

## Uninstall

- Fetch the installer:

```bash
curl -sSLO https://github.com/shivammathur/php-builder/releases/latest/download/install.sh
chmod a+x ./install.sh
```

- Then, to remove `PHP 8.4`:

```bash
./install.sh --remove 8.4
```

or, to remove `PHP 8.3`:

```bash
./install.sh --remove 8.3
```

## Related Projects
- [shivammathur/homebrew-php](https://github.com/shivammathur/homebrew-php)
- [shivammathur/php-builder-windows](https://github.com/shivammathur/php-builder-windows)
- [shivammathur/setup-php](https://github.com/shivammathur/setup-php)

## License

The scripts and documentation in this project are under the [MIT license](LICENSE). This project has multiple [dependencies](#dependencies). Their licenses can be found in their respective repositories.

## Dependencies

- [AMQP](https://github.com/php-amqp/php-amqp "AMQP PHP Extension")
- [APCU](https://github.com/krakjoe/apcu "APCU PHP Extension")
- [AST](https://github.com/nikic/php-ast "AST PHP Extension")
- [igbinary](https://github.com/igbinary/igbinary "Igbinary PHP Extension")
- [Imagick](https://github.com/Imagick/imagick "Imagick PHP Extension")
- [Memcache](https://github.com/websupport-sk/pecl-memcache "Memcache PHP Extension")
- [Memcached](https://github.com/php-memcached-dev/php-memcached "Memcached PHP Extension")
- [Msgpack](https://github.com/msgpack/msgpack-php "Msgpack PHP Extension")
- [Msphpsql](https://github.com/microsoft/msphpsql "Sqlsrv and pdo_sqlsrv extensions")
- [PEAR](https://github.com/pear/pear-core "PEAR PHP extension installer")
- [PCOV](https://github.com/krakjoe/pcov "PCOV PHP Extension")
- [PHP](https://github.com/php/php-src "PHP Upstream project")
- [php-build](https://github.com/php-build/php-build "php-build project")
- [PhpRedis](https://github.com/phpredis/phpredis "Redis PHP Extension")
- [Xdebug](https://github.com/xdebug/xdebug "Xdebug PHP Extension")
- [YAML](https://github.com/php/pecl-file_formats-yaml "YAML PHP Extension")

php-builder

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

php-builder

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README