[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:
parent
617e6bca53
commit
ae2dcc5124
24
Dockerfile
24
Dockerfile
@ -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
135
README.md
@ -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`
|
||||
|
@ -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>
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user