diff --git a/install/macos/index.xml b/install/macos/index.xml index 484607a97c..4aa9f6a839 100644 --- a/install/macos/index.xml +++ b/install/macos/index.xml @@ -1,16 +1,14 @@ - + macOS へのインストール - 本章では、PHP を macOS にインストールする際の注意事項とコツを説明します。 - PHP は Mac OS X バージョン 10.0.0 以降、 - macOS Monterey (12.0.0) より前の MacOS に標準添付されています。 - また、コンパイルの手順は - Unix へのインストールガイド - と同じです。 + PHP は macOS バージョン10 および 11 に標準添付されていましたが、 + macOS Monterey (12.0.0) 以降には含まれていません。 + 最近のバージョンにインストールするには、サードパーティーのパッケージを使用するか、 + ソースコードからコンパイルする必要があります。 &install.macos.packages; &install.macos.bundled; diff --git a/install/macos/packages.xml b/install/macos/packages.xml index b2e2ec3bf0..dc26457691 100644 --- a/install/macos/packages.xml +++ b/install/macos/packages.xml @@ -1,10 +1,10 @@ - + - パッケージの使用 + サードパーティパッケージによる macOS へのインストール macOS 用にコンパイルされた PHP パッケージがいくつか存在します。 一般的なセットアップを行うにあたって、利用することができます。ただし、 @@ -14,50 +14,33 @@ 誰か他の人が作成済みでないかを調べてみると良いでしょう。 - macOS で一番手っ取り早いインストール方法は、 - 以下のようにして、homebrew を使うやり方です。 + macOS に PHP をインストールするには、 + Homebrew + パッケージマネージャを使用すると簡単です。 - - - - - brew.sh にある手順に従って、homebrew をインストールします。 - - - - - brew install php - - - - - + + + + Web サイトの指示に従って Homebrew をインストールしてください。 + + + + + brew install php + + + 以下の場所にも、簡単にインストールできる macOS 用のコンパイル済み PHP パッケージがあります。 - - - - - MacPorts: - &url.mac.macports; - - - - - Liip: - &url.mac.liip; - (PHP 5.3 - PHP 7.3; 現在は推奨されていません) - - - - - Fink: - &url.mac.fink; - - - - + + + MacPorts + + + Fink + + - + - Debian GNU/Linux へのインストール + Debian GNU/Linux および関連ディストリビューションのパッケージからのインストール このセクションでは、Debian GNU/Linux に PHP をインストールする際の注意事項とヒントについて説明します。 + + PHP はソースコードからもインストールできますが、 + Debian GNU/Linux + パッケージからもインストール可能です。これは、Ubuntu、Kali Linux、Linux Mint + のような Debian ベースの他のディストリビューションにも当てはまります。 - - - サードパーティが作った非公式のビルドについてはここではサポートしていません。 - 何かバグを見つけた場合は、 - ダウンロードページ - から取得した最新のビルドでそれが再現するかを確認し、 - 再現しない場合は Debian チームにバグ報告をお願いします。 - - + &warn.install.third-party-support; - Unix 上で PHP をビルドする方法は Debian でもそのまま使えます。 - しかし、このページではもうひとつの方法として Debian 固有の情報を扱います。 - apt や aptitude - といったコマンドの使い方です。 - このマニュアルページでの説明は、これらふたつのコマンドのどちらを使っても実行できます。 + パッケージは、 apt または aptitude + コマンドを使用してインストールできます。 + このマニュアルでは、どちらのコマンドも同じ意味で使用します。 APT の使用 @@ -66,7 +61,7 @@ cURL、 GD などの追加モジュールもインストールしたくなることでしょう。 - これらも apt コマンドでインストールすることができます。 + これらも apt コマンドでインストールすることができます。 追加の PHP パッケージを探す方法 @@ -79,12 +74,11 @@ - 上記の出力を見てわかるとおり、(php-cgi や php-cli, php-dev といった - 特別なパッケージのほかにも) さまざまなパッケージがあり、インストールすることが可能です。 - 必要なものを見定めて、apt か - aptitude でインストールしましょう。 - Debian は依存性のチェックを行うので、たとえば MySQL と cURL - をインストールする場合はこのようになります。 + パッケージのリストには、php-cgi、php-cli、 + php-dev などの基本的な PHP コンポーネントと多くの + PHP 拡張モジュールを含む多数のパッケージが含まれます。 + 拡張モジュールがインストールされると、それらのパッケージの依存関係を満たすために、 + 必要に応じて追加のパッケージが自動的にインストールされます。 PHP と MySQL、cURL のインストール @@ -121,13 +115,6 @@ インストール後にウェブサーバーを再起動したかどうかを確認しましょう。 - - - Debian (およびその派生物) でパッケージをインストールする基本的なコマンドは - apt と aptitude のふたつです。 - しかし、これらのコマンドの微妙な違いについての説明は、このマニュアルでは行いません。 - - diff --git a/install/unix/dnf.xml b/install/unix/dnf.xml new file mode 100644 index 0000000000..145bd0ce56 --- /dev/null +++ b/install/unix/dnf.xml @@ -0,0 +1,110 @@ + + + + + DNF を使用する GNU/Linux ディストリビューションでのパッケージからのインストール + + PHP はソースコードからインストールできますが、Red Hat Enterprise Linux、 + OpenSUSE、Fedora、CentOS、Rocky Linux、Oracle Enterprise Linux のような + DNF を使用するシステム上のパッケージからインストールすることもできます。 + + &warn.install.third-party-support; + + パッケージは dnf コマンドでインストールできます。 + + + Installing packages + + まず、PEAR には php-pear、 + MySQL 拡張 には php-mysqlnd + など、 他の関連パッケージが必要になる場合があることに気をつけてください。 + + + 次に、パッケージをインストールする前に、パッケージリストが最新であることを確認するのが賢明です。 + 通常、これは dnf update コマンドを実行して行います。 + + + DNF インストールの例 + + + + + + DNF は Web サーバー に自動的に PHP のための設定をインストールしますが、 + 変更を有効化するには、以下のようなコマンドでサーバーの再起動が必要になる場合があります。 + + + Restarting Apache once PHP is installed + + + + + + + 設定のよりよい管理方法 + + これまでのセクションでは、PHP はコアモジュールのみをインストールしました。 + 次のような追加モジュールが必要になる可能性が非常に高くなります。 + + MySQL + cURL + GD + などなど… + + これらのモジュールも dnf コマンドでインストールできます。 + + + 追加の PHP パッケージを一覧する方法 + + + + + + パッケージのリストには、php-cli、php-fpm、 + php-devel などの基本的な PHP コンポーネントや、多くの PHP + 拡張モジュールを含む数多くのパッケージが含まれています。拡張モジュールがインストールされると、 + それらのパッケージの依存関係を満たすために、 + 必要に応じて追加のパッケージが自動的にインストールされます。 + + + Install PHP with MySQL, GD + + + + + + DNF は、/etc/php/8.3/php.ini、/etc/php/8.3/conf.d/*.ini + などのさまざまな &php.ini; 関連ファイルに適切な行を自動的に追加し、 + 拡張モジュールに応じて extension=foo.so のようなエントリを追加します。 + ただし、これらの変更の有効化するには、Web サーバー (Apache など) を再起動しなければなりません。 + + + + diff --git a/install/unix/index.xml b/install/unix/index.xml index 31a02049c2..7f517247d5 100644 --- a/install/unix/index.xml +++ b/install/unix/index.xml @@ -1,184 +1,39 @@ - + - - Unix システムへのインストール - - 本章では、UNIX 系のシステムへの PHP のインストールと設定に関する - 手引きを示します。使用するプラットフォームや Web サーバーについての - セクションを参照して、インストールを行ってください。 - - - このマニュアルでは、 - 「インストールにあたっての一般的な注意事項」 - の章で述べたように、Web 用のセットアップを主に扱います。加えて、 - コマンドラインから PHP を使うためのセットアップについても扱います。 - - - Unix プラットホームに PHP をインストールする方法はいくつかあり、 - コンパイルして設定するやり方と（コンパイル済みの）パッケージを使う方法とに - 別けられます。この手引きでは、コンパイルして設定する方法を主に取り上げます。 - Unix 系システムには、パッケージを用いるインストールシステムを持つものも多く、 - 一般的なセットアップを行うには、パッケージが役に立つでしょう。ただし、 - （セキュアサーバーや様々なデータベースドライバなど）少々特殊な機能が必要な場合、 - PHP や Web サーバーをビルドする必要が有るかもしれません。ソフトウエアの - ビルドに不慣れな場合は、必要な機能を含めてビルドされたパッケージを - 誰か他の人が作成済みでないかを調べてみると良いでしょう。 - - - コンパイルにあたって必要な知識とソフトウエアを以下に示します。 - - - - UNIX に関する基本的な知識 ("make" および C コンパイラを使える程度) - - - - - ANSI C コンパイラ - - - - - Web サーバー - - - - - 個別のモジュール関連のコンポーネント (GD や - PDF ライブラリなど) - - - - - - - Git から取得したソースや、自分でカスタマイズしたソースをビルドするには - さらにこれらが必要です。 - - - - autoconf: - - - - - PHP 7.3 以降: 2.68+ - - - - - PHP 7.2: 2.64+ - - - - - PHP 7.1 以前: 2.59+ - - - - - - - automake: 1.4+ - - - - - libtool: 1.4.x+ (ただし 1.4.2 は除く) - - - - - re2c: - - - - - PHP 8.3 以降: 1.0.3+ - - - - - PHP 8.2 以前: 0.13.4+ - - - - - - - bison: - - - - - PHP 7.4 以降: 3.0.0+ - - - - - PHP 7.3 以前: 2.4+ (Bison 3.x を含む) - - - - - - - - - PHP の初期設定および設定プロセスは、configure - スクリプトに与えられたコマンドラインオプションによりコントロールされます。 - ./configure --help とすると、 - オプションの一覧と簡単な解説が表示されます。 - 本マニュアルでは、オプションの種類ごとに別けて解説されています。 - PHP 本体のオプションの一覧は 付録 にまとめられています。 - 各拡張モジュール特有のオプションは、関数リファレンスのページに記述されています。 - - - - PHP の configure が完了していないと、 - 拡張モジュールや本体の実行ファイルのビルドができません。 - make コマンドの実行にあたっては、注意してください。 - configure がうまく行かず原因もよくわからない場合は、 - 問題が起きた場合 - についての章を参照ください。 - - - - - Unixシステム (OpenBSD や SELinux のような) によっては、 - セキュリティ上の理由で、 - メモリ上のページに書き込み可能属性と実行可能属性の両方を付与することを - 許可しないかもしれません。 - これは PaX MPROTECT とか W^X (Write XOR Execute) 防御と呼ばれています。 - しかしながら、この手のメモリマッピングは PCRE の JIT サポートに必要なので、 - PHP を PCRE の JIT サポート抜きでビルドする か、 - 何とかしてシステムが提供するホワイトリストに PHP のバイナリを入れなければならないでしょう。 - - - - - - Android ツール群を使った ARM 向けのクロスコンパイルには、今のところ対応していません。 - - - - - &install.unix.apache2; - &install.unix.nginx; - &install.unix.lighttpd-14; - &install.unix.litespeed; - &install.unix.commandline; - - &install.unix.openbsd; - &install.unix.solaris; - - &install.unix.debian; - - - + + Unix システムへのインストール + + ほとんどの Unix (および Linux) オペレーティングシステムとディストリビューションには、 + パッケージシステムを通じて利用できるパッケージされたバージョンの PHP と拡張モジュールがあります。 + これらのシステムを使用して PHP をインストールするための基本情報を記載したセクションがあります。 + + + 一部のディストリビューションには、バージョンや拡張モジュールなどの幅広い選択肢があるパッケージを + 提供しているサードパーティのリポジトリもあります。 + + + PHP は、一部のアプリケーションサーバーのコンポーネントとしてインストールすることもできます。 + + + + + &install.unix.debian; + &install.unix.dnf; + &install.unix.openbsd; + + &install.unix.source; + + &install.unix.commandline; + &install.unix.apache2; + &install.unix.nginx; + &install.unix.lighttpd-14; + &install.unix.litespeed; + + &install.unix.solaris; + + - OpenBSD へのインストール + OpenBSD パッケージまたは ports からのインストール このセクションでは、PHP を OpenBSD に インストールする場合に固有の注意事項とヒントについて説明します。 diff --git a/install/unix/source.xml b/install/unix/source.xml new file mode 100644 index 0000000000..c001f83b93 --- /dev/null +++ b/install/unix/source.xml @@ -0,0 +1,110 @@ + + + + + Unix および macOS システムでのソースコードからのインストール + + コンパイルに必要なソフトウェア: + + + GNU make + + + C コンパイラ (PHP 8.0.0 以降は C99、PHP 8.4.0 以降は C11 互換性が必須) + + + Web サーバー + + + モジュールごとに必要なコンポーネント + (GD、 PDF ライブラリなど) + + + + + + Git ソースから直接ビルドする場合や、PHP のソースコードをカスタムしてビルドする場合、 + 以下の追加ツールが必要になる場合があります。 + + + + autoconf: + + + + PHP 7.3 以降: バージョン 2.68 以上 + + + PHP 7.2: バージョン 2.64 以上 + + + PHP 7.1 以前: バージョン 2.59 以上 + + + + + + re2c: + + + + PHP 8.3 以降: バージョン 1.0.3 以上 + + + PHP 8.2 以前: バージョン 0.13.4 以上 + + + + + + bison: + + + + PHP 7.4 以降: バージョン 3.0.0 以上 + + + PHP 7.3 以前: バージョン 2.4+ 以上 (3.x を含む) + + + + + + + + PHP の初期セットアップと構成プロセスは、configure + スクリプトのコマンドライン オプションを使用して制御されます。 + ./configure --help を実行すると、 + 使用可能なオプションの一覧と簡単な説明が表示されます。 + このマニュアルでは、さまざまなオプションを個別に説明しています。 + 中心となる configure オプションのリストはこちら + にありますが、さまざまな拡張モジュールごとに固有のオプションについては + リファレンスページで説明されています。 + + + + 構成スクリプトが実行された後、make コマンドを使用して PHP + をビルドできます。マニュアルのインストールについてのよくある質問 + のページには、ビルドの問題の対処方法についての詳細情報があります。 + + + + + 一部の Unix システム (OpenBSD や SELinux など) では、 + PaX MPROTECT + または W^X violation + protection と呼ばれるセキュリティ上の理由から、書き込み可能ページ + と実行可能ページの両方のマッピングを禁止する場合があります。この種のメモリ + マッピングは PCRE の JIT サポートに必要であるため、PHP を + PCRE の JIT サポートなし + でビルドするか、システムが提供する何らかの手段でバイナリを + ホワイトリストに登録する必要があります。 + + + + + + いまのところ、Android ツールチェーンを使用した ARM のクロスコンパイルはサポートされていません。 + + + diff --git a/language-snippets.ent b/language-snippets.ent index 24d852e51a..a695bc0933 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -2350,6 +2350,14 @@ xattr はデフォルトでユーザー名前空間で処理を行いますが utf16, utf16le, utf16be, big5 および shiftjis.'> + + + サードパーティによるビルドは非公式であり、PHP プロジェクトによって + 直接サポートされません。発生したバグは、 + 公式ダウンロードページ + からのビルドで再現できなければ、非公式ビルドの提供元に報告してください。 + +'> diff --git a/reference/dom/domnamednodemap/getnameditem.xml b/reference/dom/domnamednodemap/getnameditem.xml index ada9df5e62..2d5c827506 100644 --- a/reference/dom/domnamednodemap/getnameditem.xml +++ b/reference/dom/domnamednodemap/getnameditem.xml @@ -1,6 +1,6 @@ - + DOMNamedNodeMap::getNamedItem @@ -58,9 +58,7 @@ $id = $doc->firstChild->attributes->getNamedItem('id'); - - 配列の文法を使ってもアクセスできます: - + 配列構文でアトリビュートにアクセスする: firstChild->attributes['id']; &reftitle.seealso; - - - DOMNamedNodeMap::getNamedItemNS - - + + DOMNamedNodeMap::getNamedItemNS +