[info=9aaa860adbc6c2ab0fea0c82ded6401e]

OBS-URL: https://build.opensuse.org/package/show/devel:BCI:Tumbleweed/php-fpm8-image?expand=0&rev=74
This commit is contained in:
Dan Čermák 2024-05-22 13:59:09 +00:00 committed by Git OBS Bridge
parent 617e6bca53
commit ae2dcc5124
3 changed files with 140 additions and 24 deletions

View File

@ -52,28 +52,8 @@ RUN chmod +x /usr/local/bin/docker-php-*
WORKDIR /srv/www/htdocs
RUN set -euo pipefail; \
cd /etc/php8/fpm/; \
test -e php-fpm.d/www.conf.default && cp -p php-fpm.d/www.conf.default php-fpm.d/www.conf; \
test -e php-fpm.conf.default && cp -p php-fpm.conf.default php-fpm.conf; \
{ \
echo '[global]'; \
echo 'error_log = /proc/self/fd/2'; \
echo; echo '; https://github.com/docker-library/php/pull/725#issuecomment-443540114'; echo 'log_limit = 8192'; \
echo; \
echo '[www]'; \
echo '; if we send this to /proc/self/fd/1, it never appears'; \
echo 'access.log = /proc/self/fd/2'; \
echo; \
echo 'clear_env = no'; \
echo; \
echo '; Ensure worker stdout and stderr are sent to the main error log.'; \
echo 'catch_workers_output = yes'; \
echo 'decorate_workers_output = no'; \
} | tee php-fpm.d/docker.conf; \
{ \
echo '[global]'; \
echo 'daemonize = no'; \
} | tee php-fpm.d/zz-docker.conf
cd /etc/php8/fpm/; \
test -e php-fpm.d/www.conf.default && cp -p php-fpm.d/www.conf.default php-fpm.d/www.conf; test -e php-fpm.conf.default && cp -p php-fpm.conf.default php-fpm.conf; { echo '[global]'; echo 'error_log = /proc/self/fd/2'; echo; echo '; https://github.com/docker-library/php/pull/725#issuecomment-443540114'; echo 'log_limit = 8192'; echo; echo '[www]'; echo '; if we send this to /proc/self/fd/1, it never appears'; echo 'access.log = /proc/self/fd/2'; echo; echo 'clear_env = no'; echo; echo '; Ensure worker stdout and stderr are sent to the main error log.'; echo 'catch_workers_output = yes'; echo 'decorate_workers_output = no'; } | tee php-fpm.d/docker.conf; { echo '[global]'; echo 'daemonize = no'; } | tee php-fpm.d/zz-docker.conf
# Override stop signal to stop process gracefully
# https://github.com/php/php-src/blob/17baa87faddc2550def3ae7314236826bc1b1398/sapi/fpm/php-fpm.8.in#L163

135
README.md
View File

@ -1,8 +1,139 @@
# The openSUSE Tumbleweed BCI PHP-FPM 8 Container Image
# The PHP FPM 8 Container Image
![Redistributable](https://img.shields.io/badge/Redistributable-Yes-green)
PHP-FPM 8 container based on the openSUSE Tumbleweed Base Container Image.
PHP is a general-purpose scripting language used primarily for server-side web
development. It can be used directly, embedded in HTML files, or executed via a
server-side Apache2 module or CGI scripts.
## How to use the image
The image contains [PHP-FPM](https://php-fpm.org/), a FastCGI implementation
for PHP that serves content via the FastCGI protocol and not via HTTP(S). This
requires a reverse proxy that can handle FastCGI and can serve content via
HTTP(s).
**Caution:** FastCGI does not offer any protection or access control, so the
open socket must be protected via network separation. This means that the
PHP-FPM container must run in a separate private network or a pod, and its
socket must be exposed to the reverse proxy only.
To deploy an application in the PHP-FPM container, copy the application into
`/srv/www/htdocs` (this directory is the `WORKDIR` of the container image):
```Dockerfile
FROM registry.opensuse.org/opensuse/bci/php-fpm:8
RUN set -eux; \
zypper -n in $my_dependencies; \
# additional setup steps
# Copy the app into the PHP-FPM document root
COPY app/ .
```
To configure NGINX as a reverse proxy, add the following to the
`server` section in `/etc/nginx/nginx.conf`:
```
location ~ \.php$ {
include fastcgi_params;
fastcgi_index index.php;
root /srv/www/htdocs/;
fastcgi_pass 127.0.0.1:9000;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
```
Additionally, create `/etc/nginx/fastcgi_params` with the following contents:
```
fastcgi_param QUERY_STRING $query_string;
fastcgi_param REQUEST_METHOD $request_method;
fastcgi_param CONTENT_TYPE $content_type;
fastcgi_param CONTENT_LENGTH $content_length;
fastcgi_param SCRIPT_NAME $fastcgi_script_name;
fastcgi_param REQUEST_URI $request_uri;
fastcgi_param DOCUMENT_URI $document_uri;
fastcgi_param DOCUMENT_ROOT $document_root;
fastcgi_param SERVER_PROTOCOL $server_protocol;
fastcgi_param REQUEST_SCHEME $scheme;
fastcgi_param HTTPS $https if_not_empty;
fastcgi_param GATEWAY_INTERFACE CGI/1.1;
fastcgi_param SERVER_SOFTWARE nginx/$nginx_version;
fastcgi_param REMOTE_ADDR $remote_addr;
fastcgi_param REMOTE_PORT $remote_port;
fastcgi_param SERVER_ADDR $server_addr;
fastcgi_param SERVER_PORT $server_port;
fastcgi_param SERVER_NAME $server_name;
# PHP only, required if PHP was built with --enable-force-cgi-redirect
fastcgi_param REDIRECT_STATUS 200;
```
If you are using a NGINX container with the above changes, you can
use a Podman pod to deploy the application:
```ShellSession
$ podman pod create --name fpm -p 80:8080
$ podman run -d --pod fpm name-of-my-fpm-container
$ podman run -d --pod fpm name-of-my-nginx-container
```
The website is served on port 8080, and the FastCGI application is not
accessible from outside of the `fpm` pod.
## How to install PHP extensions
PHP extensions must be installed using the `zypper` package manager. PHP
extensions are named using the `php8-$extension_name` scheme,
and they can be installed as follows:
```Dockerfile
FROM registry.opensuse.org/opensuse/bci/php-fpm:8
RUN zypper -n in php8-gd php8-intl
```
Alternatively, you can use the `docker-php-ext-install` script. It is provided
for compatibility with the [PHP DockerHub Image](https://hub.docker.com/_/php)
but it uses zypper to install the extensions from RPMs. It is provided for
compatibility reasons and can be used similar to the script from PHP DockerHub
image:
```Dockerfile
FROM registry.opensuse.org/opensuse/bci/php-fpm:8
RUN docker-php-ext-install gd intl
```
## How to install PECL extensions
[PECL](https://pecl.php.net/) is a package repository hosting PHP extensions. It
can be used as an alternative source to obtain PHP extensions, but without any
guarantee of interoperability with this image and without any official support.
PECL extensions can be installed as follows:
```Dockerfile
FROM registry.opensuse.org/opensuse/bci/php-fpm:8
RUN set -euo pipefail; \
zypper -n in $PHPIZE_DEPS php8-pecl; \
pecl install APCu-5.1.21;
```
**Note:** Building an extension may require installing additional dependencies.
## Compatibility with the DockerHub Image
The following scripts ship with the image to keep it compatible with the
DockerHub image: `docker-php-source`, `docker-php-ext-configure`,
`docker-php-ext-enable`, and `docker-php-ext-install`. Note that only
`docker-php-ext-install` performs an actual job. None of the other scripts
require to be executed in the image.
## Licensing
`SPDX-License-Identifier: MIT`

View File

@ -1,3 +1,8 @@
-------------------------------------------------------------------
Wed May 22 13:38:53 UTC 2024 - Dan Čermák <dcermak@suse.com>
- Extend README
-------------------------------------------------------------------
Sun May 19 09:10:06 UTC 2024 - Dan Čermák <dcermak@suse.com>