diff --git a/README.md b/README.md index d8835c15..a7553fd4 100644 --- a/README.md +++ b/README.md @@ -51,8 +51,8 @@ sudo dnf install frankenphp For extensions not available by default, use [PIE](https://github.com/php/pie): ```console -sudo dnf install php-zts-devel -sudo pie install asgrim/example-pie-extension --with-php-config=php-config-zts +sudo dnf install pie-zts +sudo pie-zts install asgrim/example-pie-extension ``` ### deb Packages @@ -71,8 +71,8 @@ sudo apt install frankenphp For extensions not available by default, use [PIE](https://github.com/php/pie): ```console -sudo apt install php-zts-devel -sudo pie install asgrim/example-pie-extension --with-php-config=php-config-zts +sudo apt install pie-zts +sudo pie-zts install asgrim/example-pie-extension ``` ### Homebrew diff --git a/docs/cn/README.md b/docs/cn/README.md index 0b4685fa..36fb0dc1 100644 --- a/docs/cn/README.md +++ b/docs/cn/README.md @@ -16,29 +16,62 @@ FrankenPHP 也可以用作独立的 Go 库,将 PHP 嵌入到任何使用 `net/ ## 开始 -### 独立二进制 - -我们为 Linux 和 macOS 提供包含 [PHP 8.4](https://www.php.net/releases/8.4/zh.php) 以及大多数常用 PHP 扩展的 FrankenPHP 静态二进制文件。 - 在 Windows 上,请使用 [WSL](https://learn.microsoft.com/windows/wsl/) 运行 FrankenPHP。 -你可以 [下载 FrankenPHP](https://github.com/dunglas/frankenphp/releases),或将以下命令复制到终端中,自动安装适用于你平台的版本: +### 安装脚本 + +你可以将以下命令复制到终端中,自动安装适用于你平台的版本: ```console curl https://frankenphp.dev/install.sh | sh -mv frankenphp /usr/local/bin/ ``` -要提供当前目录的内容,请运行: +### 独立二进制 + +我们为 Linux 和 macOS 提供用于开发的 FrankenPHP 静态二进制文件, +包含 [PHP 8.4](https://www.php.net/releases/8.4/zh.php) 以及大多数常用 PHP 扩展。 + +[下载 FrankenPHP](https://github.com/dunglas/frankenphp/releases) + +**安装扩展:** 常见扩展已内置,无法再安装更多扩展。 + +### rpm 软件包 + +我们的维护者为所有使用 `dnf` 的系统提供 rpm 包。安装方式: ```console -frankenphp php-server +sudo dnf install https://rpm.henderkes.com/static-php-1-0.noarch.rpm +sudo dnf module enable php-zts:static-8.4 # 可用 8.2-8.5 +sudo dnf install frankenphp ``` -你还可以使用以下命令运行命令行脚本: +**安装扩展:** `sudo dnf install php-zts-` + +对于默认不可用的扩展,请使用 [PIE](https://github.com/php/pie): ```console -frankenphp php-cli /path/to/your/script.php +sudo dnf install pie-zts +sudo pie-zts install asgrim/example-pie-extension +``` + +### deb 软件包 + +我们的维护者为所有使用 `apt` 的系统提供 deb 包。安装方式: + +```console +sudo curl -fsSL https://key.henderkes.com/static-php.gpg -o /usr/share/keyrings/static-php.gpg && \ +echo "deb [signed-by=/usr/share/keyrings/static-php.gpg] https://deb.henderkes.com/ stable main" | sudo tee /etc/apt/sources.list.d/static-php.list && \ +sudo apt update +sudo apt install frankenphp +``` + +**安装扩展:** `sudo apt install php-zts-` + +对于默认不可用的扩展,请使用 [PIE](https://github.com/php/pie): + +```console +sudo apt install pie-zts +sudo pie-zts install asgrim/example-pie-extension ``` ### Docker @@ -68,12 +101,28 @@ FrankenPHP 也作为 [Homebrew](https://brew.sh) 软件包提供,适用于 mac brew install dunglas/frankenphp/frankenphp ``` +**安装扩展:** 使用 [PIE](https://github.com/php/pie)。 + +### 用法 + 要提供当前目录的内容,请运行: ```console frankenphp php-server ``` +你还可以使用以下命令运行命令行脚本: + +```console +frankenphp php-cli /path/to/your/script.php +``` + +对于 deb 和 rpm 软件包,还可以启动 systemd 服务: + +```console +sudo systemctl start frankenphp +``` + ## 文档 - [Classic 模式](classic.md) diff --git a/docs/fr/README.md b/docs/fr/README.md index 61118533..761c9dac 100644 --- a/docs/fr/README.md +++ b/docs/fr/README.md @@ -16,30 +16,63 @@ Découvrez plus de détails sur ce serveur d’application dans le replay de cet ## Pour Commencer -### Binaire autonome +Sur Windows, utilisez [WSL](https://learn.microsoft.com/windows/wsl/) pour exécuter FrankenPHP. -Si vous préférez ne pas utiliser Docker, nous fournissons des binaires autonomes de FrankenPHP pour Linux et macOS -contenant [PHP 8.4](https://www.php.net/releases/8.4/fr.php) et la plupart des extensions PHP populaires. +### Script d'installation -Sous Windows, utilisez [WSL](https://learn.microsoft.com/windows/wsl/) pour exécuter FrankenPHP. - -[Téléchargez FrankenPHP](https://github.com/php/frankenphp/releases) ou copiez cette ligne dans votre terminal pour installer automatiquement la version appropriée à votre plateforme : +Vous pouvez copier cette ligne dans votre terminal pour installer automatiquement +une version adaptée à votre plateforme : ```console curl https://frankenphp.dev/install.sh | sh -mv frankenphp /usr/local/bin/ ``` -Pour servir le contenu du répertoire courant, exécutez : +### Binaire autonome + +Nous fournissons des binaires statiques de FrankenPHP pour le développement, pour Linux et macOS, +contenant [PHP 8.4](https://www.php.net/releases/8.4/fr.php) et la plupart des extensions PHP populaires. + +[Télécharger FrankenPHP](https://github.com/php/frankenphp/releases) + +**Installation d'extensions :** Les extensions les plus courantes sont incluses. Il n'est pas possible d'en installer davantage. + +### Paquets rpm + +Nos mainteneurs proposent des paquets rpm pour tous les systèmes utilisant `dnf`. Pour installer, exécutez : ```console -frankenphp php-server +sudo dnf install https://rpm.henderkes.com/static-php-1-0.noarch.rpm +sudo dnf module enable php-zts:static-8.4 # 8.2-8.5 disponibles +sudo dnf install frankenphp ``` -Vous pouvez également exécuter des scripts en ligne de commande avec : +**Installation d'extensions :** `sudo dnf install php-zts-` + +Pour les extensions non disponibles par défaut, utilisez [PIE](https://github.com/php/pie) : ```console -frankenphp php-cli /path/to/your/script.php +sudo dnf install pie-zts +sudo pie-zts install asgrim/example-pie-extension +``` + +### Paquets deb + +Nos mainteneurs proposent des paquets deb pour tous les systèmes utilisant `apt`. Pour installer, exécutez : + +```console +sudo curl -fsSL https://key.henderkes.com/static-php.gpg -o /usr/share/keyrings/static-php.gpg && \ +echo "deb [signed-by=/usr/share/keyrings/static-php.gpg] https://deb.henderkes.com/ stable main" | sudo tee /etc/apt/sources.list.d/static-php.list && \ +sudo apt update +sudo apt install frankenphp +``` + +**Installation d'extensions :** `sudo apt install php-zts-` + +Pour les extensions non disponibles par défaut, utilisez [PIE](https://github.com/php/pie) : + +```console +sudo apt install pie-zts +sudo pie-zts install asgrim/example-pie-extension ``` ### Docker @@ -69,12 +102,28 @@ Pour l'installer : brew install dunglas/frankenphp/frankenphp ``` +**Installation d'extensions :** Utilisez [PIE](https://github.com/php/pie). + +### Utilisation + Pour servir le contenu du répertoire courant, exécutez : ```console frankenphp php-server ``` +Vous pouvez également exécuter des scripts en ligne de commande avec : + +```console +frankenphp php-cli /path/to/your/script.php +``` + +Pour les paquets deb et rpm, vous pouvez aussi démarrer le service systemd : + +```console +sudo systemctl start frankenphp +``` + ## Documentation - [Le mode classique](classic.md) diff --git a/docs/ja/README.md b/docs/ja/README.md index fe5da0d4..c9c8f07d 100644 --- a/docs/ja/README.md +++ b/docs/ja/README.md @@ -16,31 +16,62 @@ FrankenPHPはあらゆるPHPアプリと連携し、ワーカーモードの公 ## はじめに -### スタンドアロンバイナリ - -LinuxとmacOS向けに、[PHP 8.4](https://www.php.net/releases/8.4/en.php)と人気のPHP拡張モジュールを含む静的な -FrankenPHPバイナリを提供しています。 - Windowsをお使いの場合は、[WSL](https://learn.microsoft.com/windows/wsl/)を使用してFrankenPHPを実行してください。 -[FrankenPHPをダウンロード](https://github.com/php/frankenphp/releases)するか、以下のコマンドを -ターミナルにコピーして実行すると、環境に合ったバージョンが自動的にインストールされます: +### インストールスクリプト + +以下のコマンドをターミナルに貼り付けると、環境に合ったバージョンが自動的にインストールされます: ```console curl https://frankenphp.dev/install.sh | sh -mv frankenphp /usr/local/bin/ ``` -現在のディレクトリのコンテンツを配信するには、以下を実行してください: +### スタンドアロンバイナリ + +LinuxとmacOS向けに、開発用途の静的FrankenPHPバイナリを提供しています。 +[PHP 8.4](https://www.php.net/releases/8.4/en.php)と主要なPHP拡張が含まれます。 + +[FrankenPHPをダウンロード](https://github.com/php/frankenphp/releases) + +**拡張のインストール:** よく使われる拡張は同梱されています。追加の拡張をインストールすることはできません。 + +### rpm パッケージ + +メンテナーが `dnf` を使用するすべてのシステム向けに rpm パッケージを提供しています。インストール方法: ```console -frankenphp php-server +sudo dnf install https://rpm.henderkes.com/static-php-1-0.noarch.rpm +sudo dnf module enable php-zts:static-8.4 # 8.2-8.5 利用可能 +sudo dnf install frankenphp ``` -コマンドラインスクリプトも実行できます: +**拡張のインストール:** `sudo dnf install php-zts-` + +デフォルトで提供されていない拡張については [PIE](https://github.com/php/pie) を使用してください: ```console -frankenphp php-cli /path/to/your/script.php +sudo dnf install pie-zts +sudo pie-zts install asgrim/example-pie-extension +``` + +### deb パッケージ + +メンテナーが `apt` を使用するすべてのシステム向けに deb パッケージを提供しています。インストール方法: + +```console +sudo curl -fsSL https://key.henderkes.com/static-php.gpg -o /usr/share/keyrings/static-php.gpg && \ +echo "deb [signed-by=/usr/share/keyrings/static-php.gpg] https://deb.henderkes.com/ stable main" | sudo tee /etc/apt/sources.list.d/static-php.list && \ +sudo apt update +sudo apt install frankenphp +``` + +**拡張のインストール:** `sudo apt install php-zts-` + +デフォルトで提供されていない拡張については [PIE](https://github.com/php/pie) を使用してください: + +```console +sudo apt install pie-zts +sudo pie-zts install asgrim/example-pie-extension ``` ### Docker @@ -70,12 +101,28 @@ FrankenPHPはmacOSおよびLinux向けに[Homebrew](https://brew.sh)パッケー brew install dunglas/frankenphp/frankenphp ``` +**拡張のインストール:** [PIE](https://github.com/php/pie) を使用してください。 + +### 使い方 + 現在のディレクトリのコンテンツを配信するには、以下を実行してください: ```console frankenphp php-server ``` +コマンドラインスクリプトも実行できます: + +```console +frankenphp php-cli /path/to/your/script.php +``` + +deb / rpm パッケージの場合は、systemd サービスを起動することもできます: + +```console +sudo systemctl start frankenphp +``` + ## ドキュメント - [クラシックモード](https://frankenphp.dev/docs/classic/) diff --git a/docs/pt-br/README.md b/docs/pt-br/README.md index bb8533fc..b1556103 100644 --- a/docs/pt-br/README.md +++ b/docs/pt-br/README.md @@ -24,22 +24,64 @@ conjunto de slides: ## Começando -### Binário independente - -Fornecemos binários estáticos do FrankenPHP para Linux e macOS contendo o -[PHP 8.4](https://www.php.net/releases/8.4/pt_BR.php) e as extensões PHP mais -populares. - No Windows, use [WSL](https://learn.microsoft.com/pt-br/windows/wsl/) para executar o FrankenPHP. -[Baixe o FrankenPHP](https://github.com/php/frankenphp/releases) ou copie esta -linha no seu terminal para instalar automaticamente a versão apropriada para sua -plataforma: +### Script de instalação + +Você pode copiar esta linha no seu terminal para instalar automaticamente a +versão apropriada para sua plataforma: ```console curl https://frankenphp.dev/install.sh | sh -mv frankenphp /usr/local/bin/ +``` + +### Binário independente + +Fornecemos binários estáticos do FrankenPHP para desenvolvimento em Linux e macOS contendo o +[PHP 8.4](https://www.php.net/releases/8.4/pt_BR.php) e as extensões PHP mais populares. + +[Baixe o FrankenPHP](https://github.com/php/frankenphp/releases) + +**Instalação de extensões:** As extensões mais comuns já estão incluídas. Não é possível instalar mais extensões. + +### Pacotes rpm + +Nossos mantenedores oferecem pacotes rpm para todos os sistemas que usam `dnf`. Para instalar, execute: + +```console +sudo dnf install https://rpm.henderkes.com/static-php-1-0.noarch.rpm +sudo dnf module enable php-zts:static-8.4 # 8.2-8.5 disponíveis +sudo dnf install frankenphp +``` + +**Instalação de extensões:** `sudo dnf install php-zts-` + +Para extensões não disponíveis por padrão, use o [PIE](https://github.com/php/pie): + +```console +sudo dnf install pie-zts +sudo pie-zts install asgrim/example-pie-extension +``` + +### Pacotes deb + +Nossos mantenedores oferecem pacotes deb para todos os sistemas que usam `apt`. Para instalar, execute: + +```console +sudo curl -fsSL https://key.henderkes.com/static-php.gpg -o /usr/share/keyrings/static-php.gpg && \ +echo "deb [signed-by=/usr/share/keyrings/static-php.gpg] https://deb.henderkes.com/ stable main" | sudo tee /etc/apt/sources.list.d/static-php.list && \ +sudo apt update +sudo apt install frankenphp +``` + +**Instalação de extensões:** `sudo apt install php-zts-` + +Para extensões não disponíveis por padrão, use o [PIE](https://github.com/php/pie): + +```console +sudo apt install pie-zts +sudo pie-zts install asgrim/example-pie-extension ``` Para servir o conteúdo do diretório atual, execute: @@ -85,12 +127,28 @@ Para instalá-lo: brew install dunglas/frankenphp/frankenphp ``` +**Instalação de extensões:** Use o [PIE](https://github.com/php/pie). + +### Uso + Para servir o conteúdo do diretório atual, execute: ```console frankenphp php-server ``` +Você também pode executar scripts de linha de comando com: + +```console +frankenphp php-cli /caminho/para/seu/script.php +``` + +Para os pacotes deb e rpm, você também pode iniciar o serviço systemd: + +```console +sudo systemctl start frankenphp +``` + ## Documentação - [Modo clássico](classic.md) diff --git a/docs/ru/README.md b/docs/ru/README.md index 1da031f8..4f263909 100644 --- a/docs/ru/README.md +++ b/docs/ru/README.md @@ -16,6 +16,63 @@ FrankenPHP также может использоваться как автон ## Начало работы +В Windows используйте [WSL](https://learn.microsoft.com/windows/wsl/) для запуска FrankenPHP. + +### Скрипт установки + +Скопируйте и выполните эту команду в терминале, чтобы автоматически установить подходящую версию для вашей платформы: + +```console +curl https://frankenphp.dev/install.sh | sh +``` + +### Автономный бинарный файл + +Если вы предпочитаете не использовать Docker, мы предоставляем автономные статические бинарные файлы FrankenPHP для Linux и macOS, включающие [PHP 8.4](https://www.php.net/releases/8.4/en.php) и большинство популярных PHP‑расширений. + +[Скачать FrankenPHP](https://github.com/php/frankenphp/releases) + +**Установка расширений:** Наиболее распространенные расширения уже включены. Устанавливать дополнительные расширения невозможно. + +### Пакеты rpm + +Наши мейнтейнеры предлагают rpm‑пакеты для всех систем с `dnf`. Для установки выполните: + +```console +sudo dnf install https://rpm.henderkes.com/static-php-1-0.noarch.rpm +sudo dnf module enable php-zts:static-8.4 # доступны 8.2–8.5 +sudo dnf install frankenphp +``` + +**Установка расширений:** `sudo dnf install php-zts-` + +Для расширений, недоступных по умолчанию, используйте [PIE](https://github.com/php/pie): + +```console +sudo dnf install pie-zts +sudo pie-zts install asgrim/example-pie-extension +``` + +### Пакеты deb + +Наши мейнтейнеры предлагают deb‑пакеты для всех систем с `apt`. Для установки выполните: + +```console +sudo curl -fsSL https://key.henderkes.com/static-php.gpg -o /usr/share/keyrings/static-php.gpg && \ +echo "deb [signed-by=/usr/share/keyrings/static-php.gpg] https://deb.henderkes.com/ stable main" | sudo tee /etc/apt/sources.list.d/static-php.list && \ +sudo apt update +sudo apt install frankenphp +``` + +**Установка расширений:** `sudo apt install php-zts-` + +Для расширений, недоступных по умолчанию, используйте [PIE](https://github.com/php/pie): + +```console +sudo apt install pie-zts +sudo pie-zts install asgrim/example-pie-extension +``` + ### Docker ```console @@ -31,31 +88,36 @@ docker run -v .:/app/public \ > Не используйте `https://127.0.0.1`. Используйте `https://localhost` и настройте самоподписанный сертификат. > Чтобы изменить используемый домен, настройте переменную окружения [`SERVER_NAME`](config.md#переменные-окружения). -### Автономный бинарный файл +### Homebrew -Если вы предпочитаете не использовать Docker, мы предоставляем автономный бинарный файл FrankenPHP для Linux и macOS, включающий [PHP 8.4](https://www.php.net/releases/8.4/en.php) и большинство популярных PHP-расширений. - -Для Windows используйте [WSL](https://learn.microsoft.com/windows/wsl/) для запуска FrankenPHP. - -[Скачать FrankenPHP](https://github.com/php/frankenphp/releases) или выполните следующую команду для автоматической установки подходящей версии: +FrankenPHP также доступен как пакет [Homebrew](https://brew.sh) для macOS и Linux. ```console -curl https://frankenphp.dev/install.sh | sh -mv frankenphp /usr/local/bin/ +brew install dunglas/frankenphp/frankenphp ``` -Для запуска содержимого текущей директории выполните: +**Установка расширений:** Используйте [PIE](https://github.com/php/pie). + +### Использование + +Для запуска содержимого текущего каталога выполните: ```console frankenphp php-server ``` -Вы также можете запускать CLI-скрипты: +Также можно запускать CLI‑скрипты: ```console frankenphp php-cli /path/to/your/script.php ``` +Для пакетов deb и rpm можно запустить сервис systemd: + +```console +sudo systemctl start frankenphp +``` + ## Документация - [Worker режим](https://frankenphp.dev/docs/worker/) diff --git a/docs/tr/README.md b/docs/tr/README.md index 1ac1e4f4..c60a7484 100644 --- a/docs/tr/README.md +++ b/docs/tr/README.md @@ -16,6 +16,64 @@ FrankenPHP, PHP'yi `net/http` kullanarak herhangi bir uygulamaya yerleştirmek i ## Başlarken +Windows üzerinde FrankenPHP çalıştırmak için [WSL](https://learn.microsoft.com/windows/wsl/) kullanın. + +### Kurulum Betiği + +Platformunuza uygun sürümü otomatik olarak kurmak için bu satırı terminalinize kopyalayabilirsiniz: + +```console +curl https://frankenphp.dev/install.sh | sh +``` + +### Binary Çıktısı + +Docker kullanmayı tercih etmiyorsanız, Linux ve macOS için geliştirme amaçlı bağımsız (statik) FrankenPHP binary dosyaları sağlıyoruz; +[PHP 8.4](https://www.php.net/releases/8.4/en.php) ve en popüler PHP eklentilerinin çoğu dahildir. + +[FrankenPHP'yi indirin](https://github.com/php/frankenphp/releases) + +**Eklenti kurulumu:** Yaygın eklentiler paketle birlikte gelir. Daha fazla eklenti yüklemek mümkün değildir. + +### rpm Paketleri + +Bakımcılarımız `dnf` kullanan tüm sistemler için rpm paketleri sunuyor. Kurulum için: + +```console +sudo dnf install https://rpm.henderkes.com/static-php-1-0.noarch.rpm +sudo dnf module enable php-zts:static-8.4 # 8.2-8.5 mevcut +sudo dnf install frankenphp +``` + +**Eklenti kurulumu:** `sudo dnf install php-zts-` + +Varsayılan olarak mevcut olmayan eklentiler için [PIE](https://github.com/php/pie) kullanın: + +```console +sudo dnf install pie-zts +sudo pie-zts install asgrim/example-pie-extension +``` + +### deb Paketleri + +Bakımcılarımız `apt` kullanan tüm sistemler için deb paketleri sunuyor. Kurulum için: + +```console +sudo curl -fsSL https://key.henderkes.com/static-php.gpg -o /usr/share/keyrings/static-php.gpg && \ +echo "deb [signed-by=/usr/share/keyrings/static-php.gpg] https://deb.henderkes.com/ stable main" | sudo tee /etc/apt/sources.list.d/static-php.list && \ +sudo apt update +sudo apt install frankenphp +``` + +**Eklenti kurulumu:** `sudo apt install php-zts-` + +Varsayılan olarak mevcut olmayan eklentiler için [PIE](https://github.com/php/pie) kullanın: + +```console +sudo apt install pie-zts +sudo pie-zts install asgrim/example-pie-extension +``` + ### Docker ```console @@ -31,23 +89,36 @@ docker run -v $PWD:/app/public \ > `https://127.0.0.1` kullanmaya çalışmayın. `https://localhost` kullanın ve kendinden imzalı sertifikayı kabul edin. > Kullanılacak alan adını değiştirmek için [`SERVER_NAME` ortam değişkenini](https://frankenphp.dev/tr/docs/config#ortam-değişkenleri) kullanın. -### Binary Çıktısı +### Homebrew -Docker kullanmayı tercih etmiyorsanız, Linux ve macOS için bağımsız FrankenPHP binary dosyası sağlıyoruz -[PHP 8.4](https://www.php.net/releases/8.4/en.php) ve en popüler PHP eklentilerini de içermekte: [FrankenPHP](https://github.com/php/frankenphp/releases) indirin +FrankenPHP, macOS ve Linux için [Homebrew](https://brew.sh) paketi olarak da mevcuttur. -Geçerli dizinin içeriğini başlatmak için çalıştırın: +```console +brew install dunglas/frankenphp/frankenphp +``` + +**Eklenti kurulumu:** [PIE](https://github.com/php/pie) kullanın. + +### Kullanım + +Geçerli dizinin içeriğini sunmak için çalıştırın: ```console frankenphp php-server ``` -Ayrıca aşağıdaki tek komut satırı ile de çalıştırabilirsiniz: +Komut satırı betiklerini şu şekilde çalıştırabilirsiniz: ```console frankenphp php-cli /path/to/your/script.php ``` +deb ve rpm paketleri için systemd servisini de başlatabilirsiniz: + +```console +sudo systemctl start frankenphp +``` + ## Docs - [Worker modu](worker.md)