Refactor PHP configuration and Docker setup:

- Mount `php.ini` in `docker-compose.yml` for better flexibility.
- Remove redundant `php.ini` copies and preload directives in Dockerfiles.
- Consolidate `tokio_sapi` extension enablement using `tokio_sapi.ini`.

Author: diolektor

Dockerfile

@@ -87,14 +87,8 @@ RUN EXT_DIR=$(php-config --extension-dir) && \
 COPY --from=builder /app/ext/modules/tokio_sapi.so /tmp/tokio_sapi.so
 RUN EXT_DIR=$(php-config --extension-dir) && \
     cp /tmp/tokio_sapi.so "$EXT_DIR/" && \
-    rm /tmp/tokio_sapi.so /tmp/php_ext_dir
-
-# Copy PHP configuration (OPcache, JIT, tokio_sapi)
-COPY php.ini /usr/local/etc/php/conf.d/tokio_php.ini
-
-# Enable preloading for dev image
-RUN echo "opcache.preload=/var/www/html/preload.php" >> /usr/local/etc/php/conf.d/tokio_php.ini && \
-    echo "opcache.preload_user=www-data" >> /usr/local/etc/php/conf.d/tokio_php.ini
+    rm /tmp/tokio_sapi.so /tmp/php_ext_dir && \
+    echo "extension=tokio_sapi.so" >> /usr/local/etc/php/conf.d/tokio_sapi.ini
 
 # Create app directory
 WORKDIR /app

Dockerfile.release

@@ -83,7 +83,7 @@ COPY build.rs ./
 RUN RUSTFLAGS="-C target-feature=-crt-static" cargo build --release
 
 # =============================================================================
-# Distribution stage - extract binaries and config
+# Distribution stage - extract binaries only
 # =============================================================================
 FROM scratch AS dist
 
@@ -93,9 +93,6 @@ COPY --from=builder /app/target/release/tokio_php /tokio_php
 # PHP extension
 COPY --from=builder /app/ext/modules/tokio_sapi.so /tokio_sapi.so
 
-# PHP configuration
-COPY php.ini /php.ini
-
 # =============================================================================
 # Minimal runtime stage (default)
 # =============================================================================
@@ -110,10 +107,8 @@ RUN apk add --no-cache libgcc
 COPY --from=builder /app/ext/modules/tokio_sapi.so /tmp/tokio_sapi.so
 RUN EXT_DIR=$(php-config --extension-dir) && \
     cp /tmp/tokio_sapi.so "$EXT_DIR/" && \
-    rm /tmp/tokio_sapi.so
-
-# Copy PHP configuration (OPcache, JIT, tokio_sapi)
-COPY php.ini /usr/local/etc/php/conf.d/tokio_php.ini
+    rm /tmp/tokio_sapi.so && \
+    echo "extension=tokio_sapi.so" >> /usr/local/etc/php/conf.d/tokio_sapi.ini
 
 # Copy binary
 COPY --from=builder /app/target/release/tokio_php /usr/local/bin/tokio_php

docker-compose.yml

@@ -42,6 +42,8 @@ services:
       - REQUEST_TIMEOUT=${REQUEST_TIMEOUT:-2m}
     volumes:
       - ./www:/var/www/html:ro
+      # PHP configuration (OPcache, JIT, etc.)
+      - ./php.ini:/usr/local/etc/php/conf.d/tokio_php.ini:ro
     restart: unless-stopped
     healthcheck:
       test: ["CMD", "curl", "-sf", "http://localhost:9090/health"]
@@ -82,6 +84,7 @@ services:
       - REQUEST_TIMEOUT=${REQUEST_TIMEOUT:-2m}
     volumes:
       - ./www:/var/www/html:ro
+      - ./php.ini:/usr/local/etc/php/conf.d/tokio_php.ini:ro
       - ./certs:/certs:ro
     restart: unless-stopped
     healthcheck:

php.ini

@@ -1,4 +1,8 @@
 ; tokio_php configuration
+;
+; Mount this file via docker-compose:
+;   volumes:
+;     - ./php.ini:/usr/local/etc/php/conf.d/tokio_php.ini:ro
 
 [opcache]
 opcache.enable = 1
@@ -10,13 +14,11 @@ opcache.validate_timestamps = 0
 opcache.revalidate_freq = 0
 opcache.jit_buffer_size = 64M
 opcache.jit = tracing
-; Preloading - runs preload.php at startup to cache framework classes
+
+; Preloading - uncomment for frameworks (Laravel, Symfony)
 ; opcache.preload = /var/www/html/preload.php
 ; opcache.preload_user = www-data
 
-[tokio_sapi]
-extension = tokio_sapi.so
-
 [Session]
 session.save_path = /tmp
 session.use_cookies = 1