「PHP」の版間の差分
(最新英語版に同期) |
(同期) |
||
7行目: | 7行目: | ||
[[ru:PHP]] |
[[ru:PHP]] |
||
[[sr:PHP]] |
[[sr:PHP]] |
||
+ | [[zh-CN:PHP]] |
||
− | {{Related articles start}} |
||
− | {{Related4|Pdepend}} |
||
− | {{Related4|Php-codesniffer-drupal}} |
||
− | {{Related4|PhpMetrics}} |
||
− | {{Related4|PHPLOC}} |
||
− | {{Related4|PhpDox}} |
||
− | {{Related articles end}} |
||
[http://www.php.net/ PHP] は広く使われている多目的のスクリプト言語で、特にウェブ開発に適しており HTML に埋め込むことができます。 |
[http://www.php.net/ PHP] は広く使われている多目的のスクリプト言語で、特にウェブ開発に適しており HTML に埋め込むことができます。 |
||
27行目: | 21行目: | ||
* '''lighttpd''': [[lighttpd]] を参照 |
* '''lighttpd''': [[lighttpd]] を参照 |
||
* '''nginx''': [[nginx]] を参照 |
* '''nginx''': [[nginx]] を参照 |
||
+ | * '''Hiawatha''': [[Hiawatha]] を参照。 |
||
== 設定 == |
== 設定 == |
||
38行目: | 33行目: | ||
{{Tip|2015年11月22日以前までは、{{Pkg|php-composer}} の設定は {{ic|/usr/share/php-composer/php.ini}} とは別のファイルに記述されていました。}} |
{{Tip|2015年11月22日以前までは、{{Pkg|php-composer}} の設定は {{ic|/usr/share/php-composer/php.ini}} とは別のファイルに記述されていました。}} |
||
+ | |||
+ | * [http://php.net/open-basedir open_basedir] ディレクティブは PHP がアクセスできるパスを制限します。セキュリティが高められますが、通常のプログラムの実行を妨げてしまう可能性もあります。PHP 7.0 から、上流にあわせて open_basedir は [https://www.archlinuxjp.org/news/php-70-packages-released/ デフォルトでは設定されない] ようになりました。使いたい場合は手動で設定が必要です。例: |
||
+ | |||
+ | open_basedir = /srv/http/:/home/:/tmp/:/usr/share/pear/:/usr/share/webapps/ |
||
== 拡張 == |
== 拡張 == |
||
51行目: | 50行目: | ||
===imagemagick=== |
===imagemagick=== |
||
− | {{Pkg|imagemagick}} を使うには {{ic|# pecl install imagick}} を実行してください。pecl バイナリは {{ |
+ | {{Pkg|imagemagick}} を使うには {{ic|# pecl install imagick}} を実行してください。pecl バイナリは {{AUR|php-pear}} パッケージに含まれています。そして次を追加: |
extension=imagick.so |
extension=imagick.so |
||
95行目: | 94行目: | ||
extension=pdo_sqlite.so |
extension=pdo_sqlite.so |
||
extension=sqlite3.so |
extension=sqlite3.so |
||
+ | |||
+ | === XDebug === |
||
+ | |||
+ | XDebug は var_dump() 関数による php コードのデバッグを楽にします。{{Pkg|xdebug}} をインストールして {{ic|/etc/php/php.ini}} に以下の行を追加してください: |
||
+ | |||
+ | extension=xdebug.so |
||
== キャッシュ == |
== キャッシュ == |
||
149行目: | 154行目: | ||
=== Zend Studio === |
=== Zend Studio === |
||
[http://www.zend.com/products/studio/ Zend Studio] は Eclipse ベースの公式 PHP IDE です。この IDE には自動補完・高度なコードフォーマット・WYSIWYG html エディタ・リファクタリング・db アクセスやバージョン管理の統合、さらに他の Eclipse プラグインで得ることができる Eclipse の機能全てが含まれています。AUR の {{AUR|zendstudio}} パッケージでインストール可能です。 |
[http://www.zend.com/products/studio/ Zend Studio] は Eclipse ベースの公式 PHP IDE です。この IDE には自動補完・高度なコードフォーマット・WYSIWYG html エディタ・リファクタリング・db アクセスやバージョン管理の統合、さらに他の Eclipse プラグインで得ることができる Eclipse の機能全てが含まれています。AUR の {{AUR|zendstudio}} パッケージでインストール可能です。 |
||
+ | |||
+ | == コマンドラインツール == |
||
+ | |||
+ | === Box === |
||
+ | |||
+ | [http://box-project.github.io/box2/ Box] は Phar をビルド・管理するためのアプリケーションです。{{AUR|php-box}} パッケージでインストールできます。 |
||
+ | |||
+ | === Composer === |
||
+ | |||
+ | [https://getcomposer.org/ Composer] は PHP の依存関係マネージャです。{{Pkg|php-composer}} パッケージでインストールできます。 |
||
+ | |||
+ | === PDepend === |
||
+ | |||
+ | [http://pdepend.org/ PHP Depend] (pdepend) は PHP のソフトウェアメトリクスツールです。{{AUR|pdepend}} パッケージでインストールできます。 |
||
+ | |||
+ | === PHP Coding Standards Fixer === |
||
+ | |||
+ | [http://cs.sensiolabs.org/ PHP Coding Standards Fixer] はコードを PSR-1 や PSR-2 コーディング規約にしたがって修正します。{{AUR|php-cs-fixer}} パッケージでインストールできます。 |
||
+ | |||
+ | === PHP-CodeSniffer === |
||
+ | |||
+ | [http://pear.php.net/package/PHP_CodeSniffer/ PHP CodeSniffer] は PHP, JavaScript, CSS ファイルをトークン化してコーディング規約に違反していないか確認します。{{AUR|php-codesniffer}} パッケージでインストールできます。 |
||
+ | |||
+ | === phpcov === |
||
+ | |||
+ | [https://github.com/sebastianbergmann/phpcov phpcov] は PHP_CodeCoverage ライブラリのコマンドラインフロントエンドです。{{AUR|phpcov}} パッケージでインストールできます。 |
||
+ | |||
+ | === phpDox === |
||
+ | |||
+ | [http://phpdox.de/ phpDox] は PHP プロジェクトのドキュメントジェネレータです。API ドキュメントなどが生成できます。{{AUR|phpdox}} パッケージでインストールできます。 |
||
+ | |||
+ | === PHPLoc === |
||
+ | |||
+ | [https://github.com/sebastianbergmann/phploc/ PHPLoc] は PHP プロジェクトのサイズを測定するツールです。{{AUR|phploc}} パッケージでインストールできます。 |
||
+ | |||
+ | === PhpMetrics === |
||
+ | |||
+ | [http://www.phpmetrics.org/ PhpMetrics] は PHP プロジェクトの様々なメトリクスを提供します。{{AUR|phpmetrics}} パッケージでインストールできます。 |
||
+ | |||
+ | === phptok === |
||
+ | |||
+ | [https://github.com/sebastianbergmann/phptok phptok] は PHP のソースコードファイルのトークンを素早くダンプできるツールです。{{AUR|phptok}} パッケージでインストールできます。 |
||
+ | |||
+ | === PHPUnit === |
||
+ | |||
+ | [https://phpunit.de PHPUnit] はプログラマー用の PHP テストフレームワークです。{{AUR|phpunit}} パッケージでインストールできます。 |
||
+ | |||
+ | === PHPUnit Skeleton Generator=== |
||
+ | |||
+ | [https://github.com/sebastianbergmann/phpunit-skeleton-generator PHPUnit Skeleton Generator] は実運用しているコードのクラスからテストクラスを生成したりその逆ができるツールです。{{AUR|phpunit-skeleton-generator}} パッケージでインストールできます。 |
||
== トラブルシューティング == |
== トラブルシューティング == |
||
158行目: | 213行目: | ||
=== /etc/php/php.ini が適用されない === |
=== /etc/php/php.ini が適用されない === |
||
{{ic|php.ini}} が適用されない場合、ini ファイルの名前が使用している sapi に合わせて変更されています。例えば uwsgi を使っている場合、ファイルの名前は {{ic|/etc/php/php-uwsgi.ini}} になり、cli を使っている場合 {{ic|/etc/php/php-cli.ini}} になります。 |
{{ic|php.ini}} が適用されない場合、ini ファイルの名前が使用している sapi に合わせて変更されています。例えば uwsgi を使っている場合、ファイルの名前は {{ic|/etc/php/php-uwsgi.ini}} になり、cli を使っている場合 {{ic|/etc/php/php-cli.ini}} になります。 |
||
+ | |||
+ | === PHP Warning: PHP Startup: ''<module>'': Unable to initialize module === |
||
+ | |||
+ | {{ic|php}} を実行したときにこのエラーが表示される場合、モジュールのバージョンが古くなっています。PHP のコアやモジュールは全て互換性を保つようにメンテナンスされているので Arch Linux で発生するのは稀です。 |
||
+ | |||
+ | [[AUR]] からコンパイルしたモジュールを使用していると発生することがあります。{{ic|/usr/lib/php/modules/}} のファイルの日付をチェックして確認してください。 |
||
+ | |||
+ | 修正するには、[[AUR]] を検索してモジュールにアップデートが来ていないか確認してください。 |
||
+ | |||
+ | もしモジュールがアップデートされていたら、[[AUR]] パッケージの Out of Date フラグを立ててください。 |
||
== 参照 == |
== 参照 == |
2016年2月29日 (月) 15:41時点における版
PHP は広く使われている多目的のスクリプト言語で、特にウェブ開発に適しており HTML に埋め込むことができます。
インストール
公式リポジトリから php パッケージをインストールしてください。
PHP スクリプトを普通の CGI として実行するには、php-cgi パッケージが必要です。
セットアップ
PHP はスタンドアロンで実行することもできますが、普通は Apache や nginx、lighttpd などの http サーバーと一緒に使われます。
- スタンドアロン:
php -S localhost:8000 -t public_html/
。ドキュメント を参照 - Apache: Apache HTTP Server を参照
- lighttpd: lighttpd を参照
- nginx: nginx を参照
- Hiawatha: Hiawatha を参照。
設定
メインの PHP 設定ファイルは /etc/php/php.ini
にあり豊富なドキュメントが揃っています。
/etc/php/php.ini
には以下のようにタイムゾーンを設定することが推奨されています (タイムゾーンのリスト):
date.timezone = Europe/Berlin
- PHP のコードをデバッグするためにエラーを表示したい場合、
/etc/php/php.ini
のdisplay_errors
をOn
に変更してください:
display_errors=On
- open_basedir ディレクティブは PHP がアクセスできるパスを制限します。セキュリティが高められますが、通常のプログラムの実行を妨げてしまう可能性もあります。PHP 7.0 から、上流にあわせて open_basedir は デフォルトでは設定されない ようになりました。使いたい場合は手動で設定が必要です。例:
open_basedir = /srv/http/:/home/:/tmp/:/usr/share/pear/:/usr/share/webapps/
拡張
よく使われる PHP の拡張は公式リポジトリに入っています:
# pacman -Ss php-
gd
php-gd を使うには /etc/php/php.ini
の次の行をアンコメント:
extension=gd.so
imagemagick
imagemagick を使うには # pecl install imagick
を実行してください。pecl バイナリは php-pearAUR パッケージに含まれています。そして次を追加:
extension=imagick.so
pthreads
POSIX マルチスレッディングを使いたい場合、pthreads 拡張が必要になります。pecl
を使って pthreads (http://pecl.php.net/package/pthreads) をインストールするにはスレッドセーフティフラグ --enable-maintainer-zts
を付けてコンパイルされた PHP を使わなくてはなりません。元のパッケージにフラグをつけて再ビルドするのが一番簡単な方法になります。
手順は PHP pthreads extension のページに記載されています。
mcrypt
mcrypt
モジュールが使いたい場合、php-mcrypt をインストールして /etc/php/php.ini
の extension=mcrypt.so
をアンコメントしてください:
extension=mcrypt.so
PCNTL
PCNTL を使うことでサーバーサイドのマシンにプロセスを直接作成することができるようになります。これでやりたいことがやれるようになる一方、状況をぐちゃぐちゃにするパワーを PHP に与えることにもなります。そのため、他の便利なエクステンションと同じようにロードすることはできない PHP エクステンションです。この拡張を有効にするには (デフォルトでは有効になっていません) PCNTL を PHP に組み込んでコンパイルする必要があります。
MySQL/MariaDB
MariaDB に書かれている手順に従って MySQL/MariaDB をインストール・設定ください。
/etc/php/php.ini
の 以下の行 をアンコメントします:
extension=pdo_mysql.so extension=mysqli.so
ウェブスクリプト用に権限を抑えた MySQL ユーザーを追加することができます。また、/etc/mysql/my.cnf
を編集して skip-networking
行をアンコメントすると MySQL サーバーはローカルホストからしかアクセスできなくなります。変更を適用するには MySQL の再起動が必要です。
PostgreSQL
PostgreSQL をインストール・設定したら、php-pgsql パッケージをインストールして /etc/php/php.ini
の以下の行をアンコメントしてください:
extension=pdo_pgsql.so extension=pgsql.so
Sqlite
Sqlite をインストール・設定したら、php-sqlite パッケージをインストールして /etc/php/php.ini
の以下の行をアンコメントしてください:
extension=pdo_sqlite.so extension=sqlite3.so
XDebug
XDebug は var_dump() 関数による php コードのデバッグを楽にします。xdebug をインストールして /etc/php/php.ini
に以下の行を追加してください:
extension=xdebug.so
キャッシュ
PHP には2種類のキャッシュが存在します: opcode/bytecode キャッシュと userland/user data キャッシュです。両方を使うことでアプリケーションの速度を相当上げることができるため、できるかぎり有効にすることを推奨します。
- Zend OPCache は opcode のキャッシュだけを行います。
- APCu は userland のキャッシュだけを行います。
キャッシュを最適化するために、両方を有効にしてください。以下の #OPCache と #APCu の両方を読むことで有効化できます。
OPCache
OPCache は標準の PHP ディストリビューションに付属しているため、OPCache は PHP 設定ファイルに以下の行を追加あるいはアンコメントするだけで有効化できます:
/etc/php/php.ini
zend_extension=opcache.so
PHP のウェブサイトにある 公式エントリ に OPCache のオプションのリストや推奨される設定が載っています。
APCu
APCu は php-apcu パッケージでインストールできます。/etc/php/conf.d/apcu.ini
の以下の行をアンコメントするか、以下の行を PHP 設定ファイルに追加することで有効にします:
extension=apcu.so
APCu の作者は推奨される設定を 記述 しています:
apc.enabled=1
とapc.shm_size=32M
は デフォルト値 なので設定しなくても問題ありません。- その一方
apc.ttl=7200
は 多少効果がある ようです。 - 最後に
apc.enable_cli=1
はマニュアルでは 非推奨 になっていますが、ownCloud などソフトウェアによっては必須です。
開発ツール
Aptana Studio
Aptana Studio は PHP でのプログラミングやウェブ開発に向いている IDE です。aptana-studioAUR パッケージでインストールできます。現在のバージョン (3.2.2) には PHP デバッガは含まれていません。
Eclipse PDT
Eclipse PDT は Eclipse の PHP バージョンです。eclipse-php パッケージでインストールできます。詳しくは Eclipse を参照。
JavaScript サポートや DB クエリなどのプラグインも必要になるでしょう。
Komodo
Komodo は PHP+HTML+JavaScript の素晴らしい統合を提供する IDE です。Komodo Edit にはエディタだけが含まれています。
Netbeans
PHP を含む多数の言語に対応した完全な IDE です。デバッグ・リファクタリング・コードテンプレート・自動補完・XML 機能・ウェブデザイン・開発機能 (CSS の自動補完機能や PHP/JavaScript コードのヒント) などの機能があります。netbeans パッケージでインストールしてください。
PhpStorm
JetBrains PhpStorm は JetBrains の IntelliJ IDEA プラットフォームで作られた商用・クロスプラットフォームの PHP 向け IDE です。phpstormAUR パッケージでインストールできます。あるいは phpstorm-eapAUR で30日間のトライアル版を使えます。Jetbrains からは教育用のフリーライセンスをもらうことが可能です [1]。
Zend Studio
Zend Studio は Eclipse ベースの公式 PHP IDE です。この IDE には自動補完・高度なコードフォーマット・WYSIWYG html エディタ・リファクタリング・db アクセスやバージョン管理の統合、さらに他の Eclipse プラグインで得ることができる Eclipse の機能全てが含まれています。AUR の zendstudioAUR パッケージでインストール可能です。
コマンドラインツール
Box
Box は Phar をビルド・管理するためのアプリケーションです。php-boxAUR パッケージでインストールできます。
Composer
Composer は PHP の依存関係マネージャです。php-composer パッケージでインストールできます。
PDepend
PHP Depend (pdepend) は PHP のソフトウェアメトリクスツールです。pdependAUR パッケージでインストールできます。
PHP Coding Standards Fixer
PHP Coding Standards Fixer はコードを PSR-1 や PSR-2 コーディング規約にしたがって修正します。php-cs-fixerAUR パッケージでインストールできます。
PHP-CodeSniffer
PHP CodeSniffer は PHP, JavaScript, CSS ファイルをトークン化してコーディング規約に違反していないか確認します。php-codesnifferAUR パッケージでインストールできます。
phpcov
phpcov は PHP_CodeCoverage ライブラリのコマンドラインフロントエンドです。phpcovAUR パッケージでインストールできます。
phpDox
phpDox は PHP プロジェクトのドキュメントジェネレータです。API ドキュメントなどが生成できます。phpdoxAUR パッケージでインストールできます。
PHPLoc
PHPLoc は PHP プロジェクトのサイズを測定するツールです。phplocAUR パッケージでインストールできます。
PhpMetrics
PhpMetrics は PHP プロジェクトの様々なメトリクスを提供します。phpmetricsAUR パッケージでインストールできます。
phptok
phptok は PHP のソースコードファイルのトークンを素早くダンプできるツールです。phptokAUR パッケージでインストールできます。
PHPUnit
PHPUnit はプログラマー用の PHP テストフレームワークです。phpunitAUR パッケージでインストールできます。
PHPUnit Skeleton Generator
PHPUnit Skeleton Generator は実運用しているコードのクラスからテストクラスを生成したりその逆ができるツールです。phpunit-skeleton-generatorAUR パッケージでインストールできます。
トラブルシューティング
PHP Fatal error: Class 'ZipArchive' not found
zip エクステンションが有効になっていることを確認してください。
$ grep zip /etc/php/php.ini
extension=zip.so
/etc/php/php.ini が適用されない
php.ini
が適用されない場合、ini ファイルの名前が使用している sapi に合わせて変更されています。例えば uwsgi を使っている場合、ファイルの名前は /etc/php/php-uwsgi.ini
になり、cli を使っている場合 /etc/php/php-cli.ini
になります。
PHP Warning: PHP Startup: <module>: Unable to initialize module
php
を実行したときにこのエラーが表示される場合、モジュールのバージョンが古くなっています。PHP のコアやモジュールは全て互換性を保つようにメンテナンスされているので Arch Linux で発生するのは稀です。
AUR からコンパイルしたモジュールを使用していると発生することがあります。/usr/lib/php/modules/
のファイルの日付をチェックして確認してください。
修正するには、AUR を検索してモジュールにアップデートが来ていないか確認してください。
もしモジュールがアップデートされていたら、AUR パッケージの Out of Date フラグを立ててください。