PHPモジュールのサポート

ホーム

4D v20.6

ランゲージリファレンス

PHP

PHPモジュールのサポート

このappendixでは、4DのPHPモジュール実装について説明します。以下の項目について説明します:

4DのPHPインタプリタでデフォルトで提供される標準PHPモジュールのリスト
4Dが保持しない標準PHPモジュールのリスト
追加モジュールのインストール

注: さらにモジュールを追加でインストールしたい場合には、外部 FastCGI-php インタープリタを使用する必要があります(異なるPHPインタープリターとphp.iniを使用するを参照して下さい)。

デフォルトで提供されるモジュール

以下の表は4Dにデフォルトで提供されるPHPモジュールの詳細です。

汎用モジュール

名称	Webサイト	説明
BCMath	http://php.net/bc	文字列として表された任意の大きさおよび精度の数をサポートするバイナリ計算機
		例:
		`C_LONGINT($value;$result) $value:=4 $ok:=PHP Execute("";"bcpow";$result;$value;3)`
カレンダー	http://php.net/calendar	異なったカレンダーフォーマット間の変換を簡単に行う関数の集まり。ユリウス積算日を標準とする。
		例:
		`C_LONGINT($NumberOfDays) $ok:=PHP Execute("";"cal_days_in_month";$NumberOfDays;1;2;2010)`
Ctype	http://php.net/ctype	現在のロケールに基づき文字または文字列がある文字クラスに含まれるかどうかを調べる関数。
		例:
		`// 提供された文字列のすべての文字が句読点かチェックする C_TEXT($myString) $myString:=",.;/" $ok:=PHP Execute("";"ctype_punct";$isPunct;$myString)`
日付・時刻	http://php.net/datetime	PHPスクリプトを実行するサーバから日付と時間を取得する。
		例: `// ポルトガルのリスボンにおける日の出時刻を計算する。 // 緯度: 38.4 North、 // 経度: 9 West、 // 天頂 ~= 90、 // 時差: +1 GMT C_TIME($SunriseTime) $ok:=PHP Execute("";"date_sunrise";$SunriseTime;0;1;38,41;-9;90;1)`
Exif	http://php.net/exif	画像のメタデータを扱う。
ファイル情報 (*)	http://php.net/fileinfo	ファイルのcontent-typeとエンコーディングを推測する。
Filter	http://php.net/filter	安全でないソース、例えばユーザ入力などによるデータの検証や除去を行う。
		例:
		`C_LONGINT($filterId) C_TEXT($result) $ok:=PHP Execute("";"filter_id";$filterId;"validate_email") $ok:=PHP Execute("";"filter_var";$result;"hop@123.com";$filterId)`
FTP (File Transfert Protocol)	http://php.net/ftp	FTPサーバへの詳細なアクセスを提供。
Hash	http://php.net/hash	メッセージダイジェストエンジン。さまざまなハッシュアルゴリズムを使用して、任意の長さのメッセージに対する直接的あるいは段階的な処理を可能とする。
		例:
		`C_TEXT($md5Result) $ok:=PHP Execute("";"md5";$md5Result;"this is my string to hash")`
JSON (JavaScript Object Notation)	http://php.net/json	JSONデータ交換形式の実装
LDAP	http://php.net/ldap	LDAPは、"ディレクトリサーバ" にアクセスするために使用されるプロトコル。ディレクトリとは、ツリー構造に情報を保持している特殊なデータベース。
マルチバイト文字列	http://php.net/mbstring	複数バイト文字エンコーディングの処理や文字列の変換に使用できる、文字処理のための一連の関数。
OpenSSL	http://php.net/openssl	OpenSSL の関数を使用して署名の生成、そして、データのシール (暗号化)およびオープン(復号化)を行う。
PCRE (Perl Compatible Regular Expressions)	http://php.net/pcre	Perl 5と同じシンタックスおよび語義を使用する一連の正規表現関数。
		例:
		`// この例は文字列から不要なスペースを取り除きます。 C_TEXT($myString) $myString:="foo o bar" PHP Execute("";"preg_replace";$myString;"/\\s\\s+/";" ";$myString) ALERT($myString) // $myStringからスペースの繰り返しが削除され"foo o bar"になる。`
PDO (PHP Data Objects) (*)	http://php.net/pdo	データベースアクセスのインタフェース。データベース毎のPDOドライバが必要。
PDO_SQLITE (*)	http://php.net/pdo_sqlite	SQLite 3にPHPからのアクセスを可能にする、PHP Data Objects (PDO) インタフェースを実装したドライバ。
リフレクション	http://php.net/reflection	完全なリフレクションAPIで、クラス、インターフェイス、関数、メソッド、そしてエクステンションのリバースエンジニアリングを可能にする。
Phar (PHP Archive)	http://php.net/phar	PHP アプリケーション全体をひとつの "phar" (PHP Archive) ファイルにまとめてしまい、配布やインストールを容易にする。
Session	http://php.net/session	PHPセッションのサポート
		例:
		セッションはWebアプリケーションにおいて、それぞれのリクエスト間でコンテキストを保持するために使用されます。4DでPHP Executeを実行すると、PHPスクリプトはセッションを開始し、コンテキストとして保持すべき情報を$_SESSION配列に格納することが可能となります。PHPスクリプトがセッションを使用する場合、PHP GET FULL RESPONSEコマンドを使用してPHPから返されるセッションIDを取得し、PHP Executeを呼び出す都度、事前にSET ENVIRONMENT VARIABLEコマンドを使用してセッションIDを指定しなければなりません。
		`// "PHP Execute with context" メソッド If(<>PHP_Session#"") SET ENVIRONMENT VARIABLE("HTTP_COOKIE";<>PHP_Session) End if If(PHP Execute($1)) PHP GET FULL RESPONSE($0;$errorInfos;$errorValues;$headerFields;$headerValues) $idx:=Find in array($headerFields;"Set-Cookie") If($idx>0) <>PHP_Session:=$headerValues{$idx} End if End if`
ソケット	http://php.net/sockets	BSDソケットに基づくソケット通信機能の低レベルインタフェースを実装し、クライアントとしてだけでなく、ソケットサーバとして動作させることが可能となります。
SPL (Standard PHP Library)	http://php.net/spl	標準的な問題を解決するためのインターフェイスやクラスを集めたもの。
SQLite	http://php.net/sqlite	SQLiteデータベースエンジン用の拡張。このエンジンは埋め込み可能。
SQLite3	http://php.net/sqlite3	SQLite version 3データベースをサポート。
Tokenizer	http://php.net/tokenizer	字句解析レベルの言語処理を行うことなく、PHPソースを解析/修正するツールを作成することを可能にする関数。

(*) 現時点の4Dでは、Windows上でこれらのモジュールを利用できません。

Windowsでのみ利用可能なモジュール

構造的な理由から、以下のPHPモジュールはWindows上でのみ利用可能です。

名称	Web サイト	説明
COM	http://php.net/com	COM (Component Object Model) はWindowsプラットフォーム上でアプリケーションやコンポーネントが通信を行う主な方法です。注: COMレイヤからの.Netアセンブリのインスタンス化や作成は、4D v17 R5 以降サポートされていません。
ODBC (Open DataBase Connectivity)	http://php.net/odbc	標準のODBCサポートに加え、PHPの統合ODBC関数により、独自のAPI実装にODBC APIの構文を利用したいくつかのデータベースへのアクセスが提供されます。

無効にされたモジュール

以下のPHPモジュールは4Dに実装されていません。一番右の列にその理由が記載されています:

名称	Web サイト	理由- 代わりのソリューション
DOM (Document Object Model)	http://php.net/dom	不要 - 4D XML DOM コマンドを使用。
Iconv	http://php.net/iconv	技術的な理由
LibXML	http://php.net/libxml	不要 - 4D XML DOM コマンドを使用。
LibXSLT	http://php.net/xsl	廃止 (廃止予定)
SimpleXML	http://php.net/simpleXML	風葉 - 4D XML DOM コマンドを使用。
Mimetype	http://php.net/mime-magic	廃止 (廃止予定) - Fileinfoを使用。
POSIX (Portable Operating System Interface)	http://php.net/posix	廃止 (廃止予定)。
Regular Expression (POSIX Extended)	http://php.net/regex	廃止 (廃止予定) - PCREを使用。
Crack	http://php.net/crack	ライセンスの制限。
ffmpeg	http://ffmpeg-php.sourceforge.net/	ライセンスの制限 - LAUNCH EXTERNAL PROCESSで、コマンドラインでffmpegを使用
GD (Graphics Draw) Library	http://php.net/gd	技術的な理由
Image Magick	http://php.net/manual/book.imagick.php	ライセンスの制限 - GD 2を使用。
IMAP (Internet Message Access Protocol)	http://php.net/imap	ライセンスの制限 - 4D Internet Commandsに統合されたコマンドを使用。
PDF (Portable Document Format)	http://php.net/pdf	ライセンスの制限 - Haru PDFを利用。
Mysqlnd (MySQL Native Driver)	http://dev.mysql.com/downloads/connector/php-mysqlnd/	4D環境に適切でない
XML (eXtensible Markup Language)	http://php.net/xml	不要 - 4D XML DOM コマンドを使用
XMLreader	http://php.net/xmlreader	不要 - 4D XML DOM コマンドを使用
XMLwriter	http://php.net/xmlwriter	不要 - 4D XML DOM コマンドを使用
WDDX (Web Distributed Data eXchange)	http://php.net/wddx	廃止 (廃止予定)。
Zlib	http://php.net/zlib	不要 - 4D ZipFile クラスを使用
Zip	http://php.net/zip	不要 - 4D ZipFile クラスを使用

php.ini ファイルのカスタマイズ

変更すべき "php.ini"ファイル(後述)は、4Dアプリケーションの Resources\php フォルダか(デフォルトファイル)、データベースの Resources フォルダ内(カスタムファイル)にあります。これについての詳細は、4DでPHPスクリプトを実行するを参照して下さい。

警告: "php.ini" ファイルに変更を加える場合は、十分な注意と、PHPに対する十分な知識が必要になります。カスタムの php.ini ファイルに関する詳細な情報は、4Dによって提供されている php.ini ファイル内のコメントを参考にすることができます。

注: PHP プロセスにかかる時間が比較的長い(30秒を超える)場合、自動的に'timeout' エラーが4Dに返され、プロセスは失敗します。この場合、デフォルトの timeout の時間を設定することによってPHP の実行の時間を確保することができます。これには二通りのやり方があります:

"php.ini" ファイル内の max_execution_time 変数を設定する方法(秒数の値を渡します)。警告:この設定は全てのスクリプトに影響します。
長い時間を必要とするプロセスのPHP実行スクリプト内にて set_time_limit(nbSec) コマンドを呼び出す方法。PHPスクリプトの実行に与えられる時間の最大値を nbSec に渡します。この方法は指定したスクリプトのみを変更するので、こちらの方が推奨されます。通常はセキュリティ上の理由からPHPスクリプトの timeout 値は低めに抑えるのがよいでしょう。