PHPは、Web開発において重要な役割を果たし、またzip、ハッシュ、LDAP機能など、ネイティブ言語ではまだ利用できない機能を提供するために4D v12で導入されました。4Dは、これらのPHP機能の多くをコア機能に取り込んできました。その結果、4D v20 R3ではビルトインのPHPインタプリタを削除し、v21ではPHPコマンドの廃止予定プロセスを開始することにしました。
4DからPHPコマンドを完全に削除するわけではありませんが、今後はPHPコードを実行するためにはシステムワーカーを使って実行することが強く推奨されます。
このブログでは、この移行プロセスについて説明しながら、PHP Execute コマンドを通して外部インタープリタを使用する方法や、システムワーカーでPHP コードを効率的に実行する方法を説明します。
最初のステップ: 4DビルトインのPHPインタプリタの削除
最初の変更は、4D v20 R3 で4DビルトインのPHP インタプリタが削除されることです。PHP Execute は引き続き動作しますが、外部のPHP インタプリタを使用する必要があります。外部PHP インタプリタの使い方に慣れていない場合は、このチュートリアルを参照してください。
PHP Executeを外部PHPインタプリタで使用する
外部PHP インタプリタを使用すると、いつでも新しいバージョンの PHP にアップデートしたり、セキュリティパッチがリリースされたらすぐにインストールしたりすることができます。また、より多くのPHP モジュールを使用できるようになります。
カスタムphp.iniファイルの作成
php.iniファイルは、PHPインタプリタを初期化するために使用されます。このファイルは自動的に作成され、内部インタープリタで PHP Execute を呼び出す際に使用されます。外部インタープリタを使用する場合、このファイルを手動で作成して渡す必要があります。PHP Execute を一度呼び出すと、このファイルがプロジェクトの resources フォルダに作成されます。このファイルを使用して外部PHP インタープリタを初期化し、また必要に応じてファイルを変更することが強く推奨されます。
CGI版PHPの実行
PHPを実行するには2つの方法があります：コマンドラインインターフェイス(CLI)を使用する方法と、 コモンゲートウェイインターフェイス(CGI)を使用する方法です。PHP Execute はコモンゲートウェイインターフェースを使用するので、CGI 版のPHP を実行する必要があります。
Windowsでは、PHPの公式サイトからPHPをダウンロードすることができます。このバージョンには、CLI版とCGI版の両方のPHPが含まれています。
現在のところ、公式サイトのバージョンはデフォルトでは mbstring パッケージを読み込みません。これを行うためには、php.iniファイルに以下の行を追加する必要があります：
extension_dir = "./ext/"
extension=mbstring
Mac の場合は、もう少し複雑です。Appleは、macOS にPHPをプリインストールするのを停止しました(同様の理由で、4DもPHPをプリインストールしていません)。PHP の公式サイトでは、Mac 用のビルド済みバージョンを提供していません。いくつかのサイトでビルド済みバージョンを見つけることができるかもしれませんが、 一般的にこういったものはメンテナンスがされていませんし、それを使用することも推奨されていません。この移行を支援するために、4Dではプロダクトダウンロードページにおいて、4D v20ビルトインPHPを別個のバイナリとして提供しています。このバイナリは4Dによってメンテナンスされないことに注意してください。そのため、将来MacにおいてPHPをアップグレードする必要がある場合は、自分でビルドする必要があります。ビルドの方法については、このブログ記事の後半で詳しく説明します。
その後、ターミナルにおいてPHPディレクトリ内から以下のコマンドを呼び出すことで、PHP を起動する必要があります：
php-cgi -b <address:port> -c <path_to_php.ini_file_inside_the_project_resources_folder>
または、4Dv20のビルトインPHPを使用する場合、コマンドは以下のようになります：
php-fcgi-4d -b <address:port> -c <path_to_php.ini_file_inside_the_project_resources_folder>
パスを入力するときは、特殊文字( \ や ” など)の直前に \をつけてそれらをエスケープする(\\ や \” にする)ことを忘れないでください。
PHP は4D と同じマシン上で実行される必要があるため、アドレスは 127.0.0.1 である必要があります。PHPのデフォルトポートは8002で、これは4Dが使用するデフォルトポートでもあります。 PHPを手動で実行する必要がないように、システムワーカーを使用して PHPを起動・停止することが推奨されます。
例えば、システムワーカーを使ってPHPを実行するには、以下ようなコードを使います：
var worker : 4D.SystemWorker
worker:=4D.SystemWorker.new("<path_to_php_cgi_executable> -b <address:port> -c <path_to_php.ini_file_inside_the_project_resources_folder>")
そしてPHPを終了するには、以下のようなコードを使います：
worker.terminate()
外部PHPに接続するために4Dの設定を行う
ストラクチャー設定のPHPタブを開き、PHPサーバーのIPアドレスとポートを入力します。その後、プロジェクトを再度開いてください。
ストラクチャー設定のPHPタブのデフォルトオプション。
8002はデフォルトのPHPポートで、PHPサーバーは4Dと同じマシン上で動作する必要があるため、127.0.0.1のアドレスを使用する必要があります。
PHP Execute を呼び出す
PHPサーバーは起動し、4Dも適切に設定されたので、PHP Executeをこれまでと同じシンタックスで使用することができます。 4D v20 R3 以降を使用している限り、使っていたPHPコードを変更する必要はありません。 古いバージョンで上記の方法を使用するには、 SET DATABASE PARAMETER(PHP use an external interpreter;1) を使用してください。これは現在の4D のデフォルトの設定となっています。上で説明されているインターフェースを使用したくないような場合には、同じコマンドで、PHPのIPやポートをコードで設定することもできます。
第二段階：PHP Executeの廃止予定
2つめの変更点は、4D v21においてPHP Executeが廃止予定となることです。このコマンドは機能し続けますし、4Dから削除するつもりもありません。今後アプリケーションで PHP を使用する場合は、システムワーカーを使用して PHP コードを実行することを強く推奨されます。
PHP コードの実行にシステムワーカーを使う
PHP のインストールまたはビルド
Windows では、PHP の公式ウェブサイトからPHP をダウンロードできます。
Mac では、PHP をビルドする必要があります。なぜならCLI 版の PHP が必要になる一方、4DビルトインのPHP インタプリタには高速なCGI 版しか付属していないからです。このブログ記事の後半で、その方法を詳しく説明します。
システムワーカーを使ってPHPを呼び出す
システムワーカーを使って PHP コードを実行する例を 2 つ挙げてみましょう。
最初の例では、PHP ファイルを解釈し、$result 変数に出力を取り出します。
var $worker : 4D.SystemWorker
var $result : Text
$worker:=4D.SystemWorker.new("<path_to_php_executable> -f <path_to_php_file> -c <path_to_php.ini_file_inside_the_project_resources_folder>")
$result:=$worker.wait().response
2つ目の例では、PHPを対話型シェルとして実行し、PHPコードを直接解釈するようにすることができます。PHPコードを都度実行するこの方法は、PHP を一度しか起動しないので、PHP を何度もコールする必要がある場合に最適です。
var $worker : 4D.SystemWorker
var data : Text
//onData コールバックは実行の結果をdata変数に追加します
var $options : Object
var $onData : 4D.Function
$onData:=Formula(data+=$2.data)
$options:=New object("onData"; $onData)
$worker:=4D.SystemWorker.new("<path_to_php_executable> -a -c <path_to_php.ini_file_inside_the_project_resources_folder>"; $options)
$worker.wait(1)
data:=""
$worker.postMessage("echo \"Hello World!\";\r\n")
$worker.wait(1)
$worker.terminate()
実行結果はdata変数に受け取られます。この場合、中身の結果はHello World！になります。
MacにPHPを取り込む
MacでPHPを取得する最も簡単な方法は、Homebrew を使うことです。残念ながら、Homebrew はあなたのマシン上にPHPを取り込むだけで、 PHPを配布することはできません。PHPをアプリケーションと一緒に配布したい場合には、コンパイルする必要があります。
Homebrewを使用してPHPをビルドする
Homebrewをインストールする
Homebrew をインストールするためのパッケージは GitHub にあります。
そうでなければ、ターミナルからインストールすることもできます。これには、Xcodeツールが必要です。以下のコマンドを実行することでインストールができます：
xcode-select --install
それを実行後、以下のコマンドでHomebrewをインストールすることができます：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
PHPをインストールする
それが完了したら、次のコマンドでPHPをインストールできます：
brew install php
Mac でのPHP のコンパイル
Mac で4D アプリケーションを配布する必要がある場合、埋め込みバージョンのPHPが必要になります。そのためには、PHP をコンパイルする必要があります。以下にそのための手順を記します：
Homebrewをインストールする
Homebrewをインストールするには、Xcodeツールが必要です。以下のコマンドでインストールします：
xcode-select --install
それを実行後、以下のコマンドでHomebrewをインストールすることができます：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
ユーティリティプログラムのインストール
PHP をコンパイルするには、groff と pkg-config の両方が必要です。以下のコマンドでインストールできます：
brew install groff
brew install pkg-config
OpenLDAP ライブラリのコンパイル
OpenLDAP ライブラリをダウンロードします。
圧縮ファイルの中身を展開します：
tar -zxf <name_of_the_archive>
OpenLDAPフォルダに移動し、インストールのための設定を行います：
./configure --prefix="<path_of_the_destination_folder>" --disable-backends --enable-ldap --without-fetch --without-cyrus-sasl --enable-shared=no --enable-static=yes
依存関係をコンパイルする：
make depend
ライブラリをコンパイルする：
make
インストール先フォルダにインストールする：
make install
OpenSSLライブラリをコンパイルする
OpenSSLライブラリをダウンロードします。
圧縮ファイルの中身を展開します：
tar -zxf <name_of_the_archive>
OpenSSLフォルダへと移動し、インストールのための設定を行います：
./config --prefix="<path_of_the_destination_folder>"
ライブラリをコンパイルします：
make
インストール先フォルダにインストールする：
make install
PHPをコンパイルする
PHPをダウンロードします。
圧縮ファイルの中身を取り出します：
tar -zxf <name_of_the_archive>
PHPフォルダに移動し、インストールのための設定を行います：
./configure --prefix="<path_of_the_destination_folder>" --disable-all --enable-cgi --enable-shared=no --enable-static=yes --with-openssl="<path_of_the_OpenSSL_destination_folder>" --with-ldap="<path_of_the_OpenLDAP_destination_folder>" --enable-bcmath --enable-calendar --enable-exif --enable-ftp --enable-mbstring ---disable-mbregex --enable-sockets --with-sqlite3 ---disable-posix --enable-ctype --enable-fileinfo --enable-filter --enable-pdo --with-pdo-sqlite --enable-phar --enable-session --enable-tokenizer ---disable-opcache
ライブラリをコンパイルする：
make
インストール先のフォルダにインストールする：
make install
PHP のインストール先フォルダの中には、高速なCGI 版PHP とCLI 版PHP の両方があります。高速なCGIバージョンは、PHP Execute を使用して外部PHPサーバーとして使用することができます。CLIバージョンは、システムワーカーで使用することができます。
質問があればフォーラムにお寄せ下さい
4Dでは、このPHPの移行をできるだけスムーズにしたいと考えています。私たちは、この移行にある程度の労力が必要であることを理解しており、全てのステップをアシストする用意があります。ご質問やご意見がございましたら、遠慮なくフォーラムにお寄せください。
フォーラムでPHPに関する新しいディスカッションを始める場合には、“PHP “タグを忘れないでください。そうすることで、誰もがあなたのトピックを見つけやすくなり、参加しやすくなります。