Skip to content

Commit 3424d42

Browse files
zonuexezonuexe
committed
Move/rewrite much of the macOS and Unix install instructions
Tried to put more emphasis on how to install from packages (either from distributions or third parties) and for Unix, in particular, move the stuff about compiling from source down a level so new users don't get knocked in the face with it. php/doc-en@4cb53ec
1 parent bd5ae18 commit 3424d42

File tree

8 files changed

+314
-258
lines changed

8 files changed

+314
-258
lines changed

‎install/macos/index.xml‎

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,14 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 12081e88fbd683e58a029153afd57f043df9721b Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 4cb53ecbd763db2db808e90d7eda63afb380e6df Maintainer: hirokawa Status: ready -->
44

55
<chapter xml:id="install.macosx" xmlns="http://docbook.org/ns/docbook">
66
<title>macOS へのインストール</title>
77
<para>
8-
本章では、PHP を macOS にインストールする際の注意事項とコツを説明します。
9-
PHP は Mac OS X バージョン 10.0.0 以降、
10-
macOS Monterey (12.0.0) より前の MacOS に標準添付されています。
11-
また、コンパイルの手順は
12-
<link linkend="install.unix">Unix へのインストールガイド</link>
13-
と同じです。
8+
PHP は macOS バージョン10 および 11 に標準添付されていましたが、
9+
macOS Monterey (12.0.0) 以降には含まれていません。
10+
最近のバージョンにインストールするには、サードパーティーのパッケージを使用するか、
11+
ソースコードからコンパイルする必要があります。
1412
</para>
1513
&install.macos.packages;
1614
&install.macos.bundled;

‎install/macos/packages.xml‎

Lines changed: 25 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: ab9c95affa258e0e81157b5528e9b4574c01a06c Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 4cb53ecbd763db2db808e90d7eda63afb380e6df Maintainer: hirokawa Status: ready -->
44
<!-- Credits: mumumu -->
55

66
<sect1 xml:id="install.macosx.packages" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
7-
<title>パッケージの使用</title>
7+
<title>サードパーティパッケージによる macOS へのインストール</title>
88
<simpara>
99
macOS 用にコンパイルされた PHP パッケージがいくつか存在します。
1010
一般的なセットアップを行うにあたって、利用することができます。ただし、
@@ -14,50 +14,33 @@
1414
誰か他の人が作成済みでないかを調べてみると良いでしょう。
1515
</simpara>
1616
<simpara>
17-
macOS で一番手っ取り早いインストール方法は、
18-
以下のようにして、homebrew を使うやり方です。
17+
macOS に PHP をインストールするには、
18+
<link xlink:href="https://brew.sh/">Homebrew</link>
19+
パッケージマネージャを使用すると簡単です。
1920
</simpara>
20-
<para>
21-
<orderedlist>
22-
<listitem>
23-
<para>
24-
<link xlink:href="https://brew.sh/">brew.sh</link> にある手順に従って、homebrew をインストールします。
25-
</para>
26-
</listitem>
27-
<listitem>
28-
<simpara>
29-
brew install php
30-
</simpara>
31-
</listitem>
32-
</orderedlist>
33-
</para>
34-
<simpara>
21+
<orderedlist>
22+
<listitem>
23+
<para>
24+
Web サイトの指示に従って Homebrew をインストールしてください。
25+
</para>
26+
</listitem>
27+
<listitem>
28+
<simpara>
29+
<command>brew install php</command>
30+
</simpara>
31+
</listitem>
32+
</orderedlist> <simpara>
3533
以下の場所にも、簡単にインストールできる
3634
macOS 用のコンパイル済み PHP パッケージがあります。
3735
</simpara>
38-
<para>
39-
<itemizedlist>
40-
<listitem>
41-
<simpara>
42-
MacPorts:
43-
<link xlink:href="&url.mac.macports;">&url.mac.macports;</link>
44-
</simpara>
45-
</listitem>
46-
<listitem>
47-
<simpara>
48-
Liip:
49-
<link xlink:href="&url.mac.liip;">&url.mac.liip;</link>
50-
(PHP 5.3 - PHP 7.3; 現在は推奨されていません)
51-
</simpara>
52-
</listitem>
53-
<listitem>
54-
<simpara>
55-
Fink:
56-
<link xlink:href="&url.mac.fink;">&url.mac.fink;</link>
57-
</simpara>
58-
</listitem>
59-
</itemizedlist>
60-
</para>
36+
<simplelist>
37+
<member>
38+
<link xlink:href="&url.mac.macports;">MacPorts</link>
39+
</member>
40+
<member>
41+
<link xlink:href="&url.mac.fink;">Fink</link>
42+
</member>
43+
</simplelist>
6144
</sect1>
6245

6346
<!-- Keep this comment at the end of the file

‎install/unix/debian.xml‎

Lines changed: 17 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,23 @@
11
<?xml version="1.0" encoding="UTF-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: f8682cd86a71640bf8771186d1d40881c7a0295e Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 4cb53ecbd763db2db808e90d7eda63afb380e6df Maintainer: takagi Status: ready -->
44
<!-- CREDITS: haruki -->
55
<sect1 xml:id="install.unix.debian" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
6-
<title>Debian GNU/Linux へのインストール</title>
6+
<title>Debian GNU/Linux および関連ディストリビューションのパッケージからののインストール</title>
77
<para>
88
このセクションでは、<link xlink:href="&url.debian;">Debian GNU/Linux</link> に
99
PHP をインストールする際の注意事項とヒントについて説明します。
10+
11+
PHP はソースコードからもインストールできますが、
12+
<link xlink:href="&url.debian;">Debian GNU/Linux</link>
13+
パッケージからもインストール可能です。これは、Ubuntu、Kali Linux、Linux Mint
14+
のような Debian ベースの他のディストリビューションにも当てはまります。
1015
</para>
11-
<warning>
12-
<para>
13-
サードパーティが作った非公式のビルドについてはここではサポートしていません。
14-
何かバグを見つけた場合は、
15-
<link xlink:href="&url.php.downloads;">ダウンロードページ</link>
16-
から取得した最新のビルドでそれが再現するかを確認し、
17-
再現しない場合は Debian チームにバグ報告をお願いします。
18-
</para>
19-
</warning>
16+
&warn.install.third-party-support;
2017
<para>
21-
Unix 上で PHP をビルドする方法は Debian でもそのまま使えます。
22-
しかし、このページではもうひとつの方法として Debian 固有の情報を扱います。
23-
<literal>apt</literal> や <literal>aptitude</literal>
24-
といったコマンドの使い方です。
25-
このマニュアルページでの説明は、これらふたつのコマンドのどちらを使っても実行できます。
18+
パッケージは、 <command>apt</command> または <command>aptitude</command>
19+
コマンドを使用してインストールできます。
20+
このマニュアルでは、どちらのコマンドも同じ意味で使用します。
2621
</para>
2722
<sect2 xml:id="install.unix.debian.apt">
2823
<title>APT の使用</title>
@@ -66,7 +61,7 @@
6661
<link linkend="book.curl">cURL</link>、
6762
<link linkend="book.image">GD</link>
6863
などの追加モジュールもインストールしたくなることでしょう。
69-
これらも <literal>apt</literal> コマンドでインストールすることができます。
64+
これらも <command>apt</command> コマンドでインストールすることができます。
7065
</simpara>
7166
<example xml:id="install.unix.debian.config.example">
7267
<title>追加の PHP パッケージを探す方法</title>
@@ -79,12 +74,11 @@
7974
</programlisting>
8075
</example>
8176
<simpara>
82-
上記の出力を見てわかるとおり、(php-cgi や php-cli, php-dev といった
83-
特別なパッケージのほかにも) さまざまなパッケージがあり、インストールすることが可能です。
84-
必要なものを見定めて、<literal>apt</literal> か
85-
<literal>aptitude</literal> でインストールしましょう。
86-
Debian は依存性のチェックを行うので、たとえば MySQL と cURL
87-
をインストールする場合はこのようになります。
77+
パッケージのリストには、<literal>php-cgi</literal>、<literal>php-cli</literal>、
78+
<literal>php-dev</literal> などの基本的な PHP コンポーネントと多くの
79+
PHP 拡張機能を含む多数のパッケージが含まれます。
80+
拡張機能がインストールされると、それらのパッケージの依存関係を満たすために、
81+
必要に応じて追加のパッケージが自動的にインストールされます。
8882
</simpara>
8983
<example xml:id="install.unix.debian.config.example2">
9084
<title>PHP と MySQL、cURL のインストール</title>
@@ -121,13 +115,6 @@
121115
インストール後にウェブサーバーを再起動したかどうかを確認しましょう。
122116
</simpara>
123117
</listitem>
124-
<listitem>
125-
<simpara>
126-
Debian (およびその派生物) でパッケージをインストールする基本的なコマンドは
127-
<literal>apt</literal> と <literal>aptitude</literal> のふたつです。
128-
しかし、これらのコマンドの微妙な違いについての説明は、このマニュアルでは行いません。
129-
</simpara>
130-
</listitem>
131118
</itemizedlist>
132119
</sect2>
133120
</sect1>

‎install/unix/dnf.xml‎

Lines changed: 110 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,110 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- $Revision$ -->
3+
<!-- EN-Revision: 4cb53ecbd763db2db808e90d7eda63afb380e6df Maintainer: zonuexe Status: ready -->
4+
<sect1 xml:id="install.unix.dnf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<title>DNF を使用する GNU/Linux ディストリビューションでのパッケージからのインストール</title>
6+
<simpara>
7+
PHP はソースコードからインストールできますが、Red Hat Enterprise Linux、
8+
OpenSUSE、Fedora、CentOS、Rocky Linux、Oracle Enterprise Linux のような
9+
DNF を使用するシステム上のパッケージからインストールすることもできます。
10+
</simpara>
11+
&warn.install.third-party-support;
12+
<simpara>
13+
パッケージは <command>dnf</command> コマンドでインストールできます。
14+
</simpara>
15+
<sect2 xml:id="install.unix.dnf.packages">
16+
<title>Installing packages</title>
17+
<simpara>
18+
まず、<link xlink:href="&url.pear;">PEAR</link> には <literal>php-pear</literal>、
19+
<link linkend="book.mysqlnd">MySQL 拡張</link> には <literal>php-mysqlnd</literal>
20+
など、 他の関連パッケージが必要になる場合があることに気をつけてください。
21+
</simpara>
22+
<simpara>
23+
次に、パッケージをインストールする前に、パッケージリストが最新であることを確認するのが賢明です。
24+
通常、これは <command>dnf update</command> コマンドを実行して行います。
25+
</simpara>
26+
<example xml:id="install.unix.dnf.example">
27+
<title>DNF インストールの例</title>
28+
<programlisting role="shell">
29+
<![CDATA[
30+
# dnf install php php-common
31+
]]>
32+
</programlisting>
33+
</example>
34+
<simpara>
35+
DNF は Web サーバー に自動的に PHP のための設定をインストールしますが、
36+
変更を有効化するには、以下のようなコマンドでサーバーの再起動が必要になる場合があります。
37+
</simpara>
38+
<example xml:id="install.unix.dnf.example2">
39+
<title>Restarting Apache once PHP is installed</title>
40+
<programlisting role="shell">
41+
<![CDATA[
42+
# sudo systemctl restart httpd
43+
]]>
44+
</programlisting>
45+
</example>
46+
</sect2>
47+
<sect2 xml:id="install.unix.dnf.config">
48+
<title>設定のよりよい管理方法</title>
49+
<para>
50+
これまでのセクションでは、PHP はコアモジュールのみをインストールしました。
51+
次のような追加モジュールが必要になる可能性が非常に高くなります。
52+
<simplelist type="inline">
53+
<member><link linkend="book.mysql">MySQL</link></member>
54+
<member><link linkend="book.curl">cURL</link></member>
55+
<member><link linkend="book.image">GD</link></member>
56+
<member>などなど…</member>
57+
</simplelist>
58+
これらのモジュールも <command>dnf</command> コマンドでインストールできます。
59+
</para>
60+
<example xml:id="install.unix.dnf.config.example">
61+
<title>追加の PHP パッケージを一覧する方法</title>
62+
<programlisting role="shell">
63+
<![CDATA[
64+
# dnf search php
65+
]]>
66+
</programlisting>
67+
</example>
68+
<simpara>
69+
パッケージのリストには、<literal>php-cli</literal>、<literal>php-fpm</literal>、
70+
<literal>php-devel</literal> などの基本的な PHP コンポーネントや、多くの PHP
71+
拡張機能を含む数多くのパッケージが含まれています。拡張機能がインストールされると、
72+
それらのパッケージの依存関係を満たすために、
73+
必要に応じて追加のパッケージが自動的にインストールされます。
74+
</simpara>
75+
<example xml:id="install.unix.dnf.config.example2">
76+
<title>Install PHP with MySQL, GD</title>
77+
<programlisting role="shell">
78+
<![CDATA[
79+
# dnf install php-mysqlnd php-gd
80+
]]>
81+
</programlisting>
82+
</example>
83+
<simpara>
84+
DNF は、<filename>/etc/php/8.3/php.ini</filename>、<filename>/etc/php/8.3/conf.d/*.ini</filename>
85+
などのさまざまな &php.ini; 関連ファイルに適切な行を自動的に追加し、
86+
拡張子に応じて <literal>extension=foo.so</literal> のようたエントリを追加します。
87+
ただし、これらの変更の有効化にするには、Web サーバー (Apache など) を再起動しなければなりません。
88+
</simpara>
89+
</sect2>
90+
</sect1>
91+
<!-- Keep this comment at the end of the file
92+
Local variables:
93+
mode: sgml
94+
sgml-omittag:t
95+
sgml-shorttag:t
96+
sgml-minimize-attributes:nil
97+
sgml-always-quote-attributes:t
98+
sgml-indent-step:1
99+
sgml-indent-data:t
100+
indent-tabs-mode:nil
101+
sgml-parent-document:nil
102+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
103+
sgml-exposed-tags:nil
104+
sgml-local-catalogs:nil
105+
sgml-local-ecat-files:nil
106+
End:
107+
vim600: syn=xml fen fdm=syntax fdl=2 si
108+
vim: et tw=78 syn=sgml
109+
vi: ts=1 sw=1
110+
-->

0 commit comments

Comments
 (0)