Available Extensions

Complete reference of all PHP extensions included in Cbox base images by tier.

Extension Overview by Tier

Cbox images come in four tiers with different extension sets:

Slim Tier Extensions

The Slim tier includes all core extensions needed for most PHP applications.

PHP Extensions

Tools Included

Standard Tier Extensions

The Standard tier includes everything in Slim, plus image processing and Node.js.

Additional Extensions (on top of Slim)

Additional Tools

Image Format Support (Standard Tier)

Full Tier Extensions

The Full tier includes everything in Standard, plus Chromium for browser automation.

Additional Components (on top of Standard)

Environment Variables (auto-set)

PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium-browser

Dev Tier Extensions

The Dev tier includes everything in Full, plus development and profiling tools.

Additional Extensions (on top of Full)

Xdebug Configuration

The dev tier includes pre-configured Xdebug settings:

xdebug.mode=develop,debug,coverage
xdebug.client_host=host.docker.internal
xdebug.client_port=9003
xdebug.start_with_request=trigger
xdebug.discover_client_host=true
xdebug.log=/tmp/xdebug.log
xdebug.idekey=VSCODE

Xdebug Modes:

• off - Disabled
• develop - Development helpers (var_dump improvements)
• coverage - Code coverage collection
• debug - Step debugging
• gcstats - Garbage collection statistics
• profile - Profiling
• trace - Function tracing

PCOV Configuration

PCOV is disabled by default (for faster execution). Enable it when running tests:

pcov.enabled=0
pcov.directory=/var/www/html

Usage:

# Enable PCOV for PHPUnit coverage
php -d pcov.enabled=1 vendor/bin/phpunit --coverage-text

SPX Profiler

SPX provides a web-based UI for profiling:

spx.http_enabled=1
spx.http_key=dev
spx.http_ip_whitelist=*

Access the SPX UI:

http://your-app/?SPX_KEY=dev&SPX_UI_URI=/

Dev Tier Best Practices

1. Use PCOV for CI coverage - It's 10x faster than Xdebug coverage
2. Disable Xdebug in production - Dev tier is NOT for production
3. Use SPX for performance profiling - More visual than Xdebug profiler
4. Switch modes as needed - Only enable what you need

# Fast coverage in CI
docker run --rm -e XDEBUG_MODE=off \
  -v $(pwd):/var/www/html \
  ghcr.io/cboxdk/php-baseimages/php-fpm:8.4-bookworm-dev \
  php -d pcov.enabled=1 vendor/bin/phpunit --coverage-text

# Step debugging
docker run --rm -e XDEBUG_MODE=debug \
  ghcr.io/cboxdk/php-baseimages/php-fpm:8.4-bookworm-dev \
  php artisan test

Extension Comparison by Tier

Extension Versions

All PECL extensions use pinned versions for reproducibility:

Checking Installed Extensions

List All Extensions

# In running container
docker exec myapp php -m

# One-liner
docker run --rm ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.4-bookworm php -m

Check Specific Extension

# Check if redis is loaded
docker exec myapp php -m | grep redis

# Get extension version
docker exec myapp php -r "echo phpversion('redis');"

Full Extension Info

# Detailed extension information
docker exec myapp php -i | grep -A 10 "redis"

Adding Extensions

PECL Extensions

FROM ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.4-bookworm

# Install PECL extension
RUN apt-get update && apt-get install -y $PHPIZE_DEPS && \
    pecl install swoole && \
    docker-php-ext-enable swoole && \
    apk del $PHPIZE_DEPS

Core Extensions

FROM ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.4-bookworm

# Enable a disabled core extension
RUN docker-php-ext-install shmop

System Dependencies

Some extensions require system packages:

FROM ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.4-bookworm

# Example: Adding additional libraries
RUN apt-get update && apt-get install -y some-package-dev && \
    docker-php-ext-install some-extension

Framework Requirements

Laravel

All Laravel requirements are satisfied by Slim tier:

Symfony

All Symfony requirements are satisfied by Slim tier:

WordPress

All WordPress requirements are satisfied by Standard tier (for ImageMagick):

Browsershot / Laravel Dusk

Requires Full tier for Chromium:

Troubleshooting

Extension Not Loading

# Check PHP error log
docker exec myapp cat /var/log/php/error.log

# Verify extension file exists
docker exec myapp ls /usr/local/lib/php/extensions/

Missing System Dependency

# Check for missing libraries
docker exec myapp ldd /usr/local/lib/php/extensions/*/redis.so

Version Conflicts

# Check loaded extension versions
docker exec myapp php -r "foreach(get_loaded_extensions() as \$ext) echo \$ext.': '.phpversion(\$ext).PHP_EOL;"

Need a specific extension? See Extending Images | Image Tiers Comparison