Skip to content

Commit fd2c4c0

Browse files
committed
update documentation for paths
1 parent e82a43c commit fd2c4c0

7 files changed

Lines changed: 79 additions & 24 deletions

File tree

docs/cn/config.md

Lines changed: 15 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,21 @@ FrankenPHP,Caddy 以及 Mercure 和 Vulcain 模块可以使用 [Caddy 支持
55
[Docker 映像](docker.md) 中,`Caddyfile` 位于 `/etc/frankenphp/Caddyfile`
66
静态二进制文件会在启动时所在的目录中查找 `Caddyfile`
77
PHP 本身可以[使用 `php.ini` 文件](https://www.php.net/manual/zh/configuration.file.php)进行配置。
8-
默认情况下,随 Docker 映像提供的 PHP 和静态二进制文件中包含的 PHP 将在启动 FrankenPHP 的目录和 `/usr/local/etc/php/` 中查找`php.ini` 文件。它们还会从 `/usr/local/etc/php/conf.d/` 中加载所有以 `.ini` 结尾的文件。
9-
默认情况下没有 `php.ini` 文件,因此应复制 PHP 项目提供的官方模板。
10-
在 Docker 上,模板在镜像中提供:
8+
PHP 解释器将在以下位置查找:
9+
Docker:
10+
- php.ini: `/usr/local/etc/php/` 默认情况下不提供 php.ini。
11+
- 附加配置文件: `/usr/local/etc/php/conf.d/`
12+
- php 扩展: `/usr/local/lib/php/extensions/no-debug-zts-<YYYYMMDD>/`
13+
FrankenPHP 安装 (.rpm 或 .deb),:
14+
- php.ini: `/etc/frankenphp/` 默认情况下提供带有生产预设的 php.ini 文件。
15+
- 附加配置文件: `/etc/frankenphp/php.d/`
16+
- php 扩展: `/usr/lib/frankenphp/modules/`
17+
静态二进制:
18+
- php.ini: 执行 `frankenphp run``frankenphp php-server` 的目录,然后是 `/etc/frankenphp/`
19+
- 附加配置文件: `/etc/frankenphp/php.d/`
20+
- php 扩展: `/usr/lib/frankenphp/modules/`
21+
22+
在 Docker 中,您应该复制 PHP 项目提供的官方模板:
1123

1224
```dockerfile
1325
FROM dunglas/frankenphp

docs/config.md

Lines changed: 15 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,21 @@ You can specify a custom path with the `-c` or `--config` option.
88

99
PHP itself can be configured [using a `php.ini` file](https://www.php.net/manual/en/configuration.file.php).
1010

11-
By default, PHP supplied with Docker images and the one included in the static binary will look for a `php.ini` file in the directory where FrankenPHP is started and in `/usr/local/etc/php/`. They will also load all files ending in `.ini` from `/usr/local/etc/php/conf.d/`.
12-
13-
No `php.ini` file is present by default, you should copy an official template provided by the PHP project.
14-
15-
On Docker, the templates are provided in the images:
11+
The PHP interpreter will look in the following locations:
12+
Docker:
13+
- php.ini: `/usr/local/etc/php/` No php.ini is provided by default.
14+
- additional configuration files: `/usr/local/etc/php/conf.d/`
15+
- php extensions: `/usr/local/lib/php/extensions/no-debug-zts-<YYYYMMDD>/`
16+
FrankenPHP installation (.rpm or .deb):
17+
- php.ini: `/etc/frankenphp/` A php.ini file with production presets is provided by default.
18+
- additional configuration files: `/etc/frankenphp/php.d/`
19+
- php extensions: `/usr/lib/frankenphp/modules/`
20+
Static binary:
21+
- php.ini: The directory in which `frankenphp run` or `frankenphp php-server` is executed, then `/etc/frankenphp/`
22+
- additional configuration files: `/etc/frankenphp/php.d/`
23+
- php extensions: `/usr/lib/frankenphp/modules/`
24+
25+
In Docker, you should copy an official template provided by the PHP project:
1626

1727
```dockerfile
1828
FROM dunglas/frankenphp

docs/fr/config.md

Lines changed: 15 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,21 @@ Le binaire statique cherchera le `Caddyfile` dans le répertoire dans lequel il
77

88
PHP lui-même peut être configuré [en utilisant un fichier `php.ini`](https://www.php.net/manual/fr/configuration.file.php).
99

10-
Par défaut, le PHP fourni avec les images Docker et celui inclus dans le binaire statique cherchera un fichier `php.ini` dans le répertoire dans lequel FrankenPHP est démarré et dans `/usr/local/etc/php/`. Ils chargeront également tous les fichiers se terminant par `.ini` dans `/usr/local/etc/php/conf.d/`.
11-
12-
Aucun fichier `php.ini` n'est présent par défaut, vous devriez copier un modèle officiel fourni par le projet PHP.
13-
14-
Sur Docker, les modèles sont fournis dans les images :
10+
L'interpréteur PHP cherchera dans les emplacements suivants :
11+
Docker :
12+
- php.ini : `/usr/local/etc/php/` Aucun php.ini n'est fourni par défaut.
13+
- fichiers de configuration supplémentaires : `/usr/local/etc/php/conf.d/`
14+
- extensions php : `/usr/local/lib/php/extensions/no-debug-zts-<YYYYMMDD>/`
15+
Installation de FrankenPHP (.rpm ou .deb) :
16+
- php.ini : `/etc/frankenphp/` Un fichier php.ini avec des préréglages de production est fourni par défaut.
17+
- fichiers de configuration supplémentaires : `/etc/frankenphp/php.d/`
18+
- extensions php : `/usr/lib/frankenphp/modules/`
19+
Binaire statique :
20+
- php.ini : Le répertoire dans lequel `frankenphp run` ou `frankenphp php-server` est exécuté, puis `/etc/frankenphp/`
21+
- fichiers de configuration supplémentaires : `/etc/frankenphp/php.d/`
22+
- extensions php : `/usr/lib/frankenphp/modules/`
23+
24+
Dans Docker, vous devriez copier un modèle officiel fourni par le projet PHP :
1525

1626
```dockerfile
1727
FROM dunglas/frankenphp

docs/ru/config.md

Lines changed: 15 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,21 @@ FrankenPHP, Caddy, а также модули Mercure и Vulcain могут бы
77

88
PHP можно настроить [с помощью файла `php.ini`](https://www.php.net/manual/en/configuration.file.php).
99

10-
PHP из Docker-образов и статического бинарного файла по умолчанию будет искать файл `php.ini` в директории, где был запущен FrankenPHP, а также в `/usr/local/etc/php/`. Кроме того, будут загружены все файлы с расширением `.ini` из директории `/usr/local/etc/php/conf.d/`.
11-
12-
Файл `php.ini` по умолчанию отсутствует. Вы можете скопировать официальный шаблон, предоставляемый проектом PHP.
13-
14-
В Docker-шаблоны включены в образы:
10+
PHP-интерпретатор будет искать в следующих местах:
11+
Docker:
12+
- php.ini: `/usr/local/etc/php/` По умолчанию php.ini не предоставляется.
13+
- дополнительные файлы конфигурации: `/usr/local/etc/php/conf.d/`
14+
- расширения php: `/usr/local/lib/php/extensions/no-debug-zts-<YYYYMMDD>/`
15+
Установка FrankenPHP (.rpm или .deb):
16+
- php.ini: `/etc/frankenphp/` По умолчанию предоставляется файл php.ini с производственными настройками.
17+
- дополнительные файлы конфигурации: `/etc/frankenphp/php.d/`
18+
- расширения php: `/usr/lib/frankenphp/modules/`
19+
Статический бинарный файл:
20+
- php.ini: Директория, в которой выполняется `frankenphp run` или `frankenphp php-server`, затем `/etc/frankenphp/`
21+
- дополнительные файлы конфигурации: `/etc/frankenphp/php.d/`
22+
- расширения php: `/usr/lib/frankenphp/modules/`
23+
24+
В Docker вы должны скопировать официальный шаблон, предоставляемый проектом PHP:
1525

1626
```dockerfile
1727
FROM dunglas/frankenphp

docs/tr/config.md

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,21 @@ Statik ikili, başlatıldığı dizinde `Caddyfile` dosyasını arayacaktır.
77

88
PHP'nin kendisi [bir `php.ini` dosyası kullanılarak yapılandırılabilir](https://www.php.net/manual/tr/configuration.file.php).
99

10-
Varsayılan olarak, Docker imajlarıyla birlikte verilen PHP ve statik ikili dosyada bulunan PHP, FrankenPHP'nin başlatıldığı dizinde ve `/usr/local/etc/php/` içinde bir `php.ini` dosyası arayacaktır. Ayrıca `.ini` ile biten tüm dosyaları `/usr/local/etc/php/conf.d/` dizininden yükleyecektir.
11-
12-
Öntanımlı olarak `php.ini` dosyası yoktur, PHP projesi tarafından sağlanan resmi bir şablonu kopyalamanız gerekir.
13-
Docker'da şablonlar imajlar içinde sağlanır:
10+
PHP yorumlayıcısı aşağıdaki konumlarda arama yapacaktır:
11+
Docker:
12+
- php.ini: `/usr/local/etc/php/` Varsayılan olarak php.ini sağlanmaz.
13+
- ek yapılandırma dosyaları: `/usr/local/etc/php/conf.d/`
14+
- php uzantıları: `/usr/local/lib/php/extensions/no-debug-zts-<YYYYMMDD>/`
15+
FrankenPHP kurulumu (.rpm veya .deb):
16+
- php.ini: `/etc/frankenphp/` Varsayılan olarak üretim ön ayarlarına sahip bir php.ini dosyası sağlanır.
17+
- ek yapılandırma dosyaları: `/etc/frankenphp/php.d/`
18+
- php uzantıları: `/usr/lib/frankenphp/modules/`
19+
Statik ikili:
20+
- php.ini: `frankenphp run` veya `frankenphp php-server` komutunun çalıştırıldığı dizin, ardından `/etc/frankenphp/`
21+
- ek yapılandırma dosyaları: `/etc/frankenphp/php.d/`
22+
- php uzantıları: `/usr/lib/frankenphp/modules/`
23+
24+
Docker'da, PHP projesi tarafından sağlanan resmi bir şablonu kopyalamalısınız:
1425

1526
```dockerfile
1627
FROM dunglas/frankenphp

static-builder-gnu.Dockerfile

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -116,8 +116,7 @@ ENV SPC_DEFAULT_C_FLAGS='-fPIE -fPIC -O3'
116116
ENV SPC_LIBC='glibc'
117117
ENV SPC_CMD_VAR_PHP_MAKE_EXTRA_LDFLAGS_PROGRAM='-Wl,-O3 -pie'
118118
ENV SPC_CMD_VAR_PHP_MAKE_EXTRA_LIBS='-ldl -lpthread -lm -lresolv -lutil -lrt'
119-
ENV SPC_OPT_DOWNLOAD_ARGS='--ignore-cache-sources=php-src'
120-
ENV SPC_OPT_BUILD_ARGS='--with-config-file-path=/etc/frankenphp/php.ini --with-config-file-scan-dir=/etc/frankenphp/php.d'
119+
ENV SPC_OPT_BUILD_ARGS='--with-config-file-path=/etc/frankenphp --with-config-file-scan-dir=/etc/frankenphp/php.d'
121120
ENV SPC_REL_TYPE='binary'
122121
ENV EXTENSION_DIR='/usr/lib/frankenphp/modules'
123122

static-builder-musl.Dockerfile

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -93,6 +93,9 @@ COPY --link . ./
9393
ENV SPC_DEFAULT_C_FLAGS='-fPIE -fPIC -O3'
9494
ENV SPC_LIBC='musl'
9595
ENV SPC_CMD_VAR_PHP_MAKE_EXTRA_LDFLAGS_PROGRAM='-Wl,-O3 -pie'
96+
ENV SPC_OPT_BUILD_ARGS='--with-config-file-path=/etc/frankenphp --with-config-file-scan-dir=/etc/frankenphp/php.d'
97+
ENV SPC_REL_TYPE='binary'
98+
ENV EXTENSION_DIR='/usr/lib/frankenphp/modules'
9699

97100
RUN --mount=type=secret,id=github-token GITHUB_TOKEN=$(cat /run/secrets/github-token) ./build-static.sh && \
98101
rm -Rf dist/static-php-cli/source/*

0 commit comments

Comments
 (0)