日本語
日本語
PHP開発では、サードパーティライブラリを読み込むことは一般的なタスクです。外部ライブラリを適切に導入および使用できるようにするには、通常、PHPのinclude Path（を含む）を設定する必要があります。 set_include_path（）関数は、このパスを設定または変更するために使用されるツールの1つです。この記事では、 set_include_path（）関数を正しく使用する方法を紹介し、サードパーティライブラリをより効率的にロードするのに役立つ実用的なヒントを共有します。
まず、 set_include_path（）の基本的な使用法を理解しましょう。この関数は、PHPのインクルージョンパスを設定するために使用されます。つまり、PHPが参照される、または必要なステートメントによって参照されるファイルを探す1つ以上のディレクトリを指定します。
文法：
<span><span><span class="hljs-title function_ invoke__">set_include_path</span></span><span>(</span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$path</span></span><span>);
</span></span>$ PATHパラメーターは、設定する必要があるインクルージョンパスです。それは、path_separator（semi-colon ";" windows and colon "：" unix/linuxの下）で区切られたディレクトリまたは複数のパスへのパスになります。
set_include_path（）関数を使用して、複数のディレクトリパスを柔軟に設定し、PHPがこれらのパスの下にファイルを見つけることができます。例えば：
<span><span><span class="hljs-comment">// 設定に含まれるパス</span></span><span>
</span><span><span class="hljs-title function_ invoke__">set_include_path</span></span><span>(</span><span><span class="hljs-string">'/path/to/your/library'</span></span><span> . PATH_SEPARATOR . </span><span><span class="hljs-title function_ invoke__">get_include_path</span></span><span>());
</span></span>この例では、 set_include_path（）は、/path/to/your/libraryディレクトリを既存のinclude_pathに追加します。 curlesの含まれるパスは、 get_include_path（）関数を介して取得でき、既存のパスを削除せずに新しいディレクトリを追加するようにします。
開発中、ライブラリファイルをロードするために相対パスを使用する必要がある状況に遭遇する場合があります。 set_include_path（）およびdirname（）関数を使用して、相対パスを設定できます。
<span><span><span class="hljs-comment">// 相対パスを設定します</span></span><span>
</span><span><span class="hljs-title function_ invoke__">set_include_path</span></span><span>(</span><span><span class="hljs-title function_ invoke__">dirname</span></span><span>(</span><span><span class="hljs-keyword">__FILE__</span></span><span>) . </span><span><span class="hljs-string">'/libs'</span></span><span> . PATH_SEPARATOR . </span><span><span class="hljs-title function_ invoke__">get_include_path</span></span><span>());
</span></span>ここでは、 DIRNAME（__ file__）が現在のスクリプトがあるディレクトリに戻り、 /libsはサードパーティライブラリを保存するフォルダーです。これにより、スクリプトがどこで実行されても、サードパーティライブラリに正しくロードできます。
含まれるパスが設定されると、PHPは指定したパスの順序でファイルを探します。 /path/to/your/libraryディレクトリにあるmylibrary.phpという名前のサードパーティライブラリファイルがあり、ロードするコードが次のとおりです。
<span><span><span class="hljs-comment">// サードパーティライブラリの紹介</span></span><span>
</span><span><span class="hljs-keyword">include_once</span></span><span>(</span><span><span class="hljs-string">'MyLibrary.php'</span></span><span>);
</span><span><span class="hljs-comment">// ライブラリでクラスを使用します</span></span><span>
</span><span><span class="hljs-variable">$library</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title class_">MyLibrary</span></span><span>();
</span><span><span class="hljs-variable">$library</span></span><span>-></span><span><span class="hljs-title function_ invoke__">doSomething</span></span><span>();
</span></span>set_include_path（）を介して含まれるパスを設定しているため、PHPはフルパスを書き出すことなく、これらのパスのmylibrary.phpファイルを自動的に検索します。
デバッグにパスが含まれる場合、 get_include_path（）関数を使用して現在のパス設定を表示します。これは、パスが正しいことを確認するのに非常に役立ちます。
<span><span><span class="hljs-comment">// 電流はパスを含む出力を出力します</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">get_include_path</span></span><span>();
</span></span>現在のパスを出力することにより、PHPが検索しているディレクトリのリストをはっきりと見ることができます。問題がある場合は、パス設定をチェックすることで理由を見つけることができます。
パス順序は重要です。Set_include_path （）によって設定されたパスは、順番に検索されます。ディレクトリの注文が正しくない場合、一部のライブラリファイルは正しくロードされない場合があります。
デフォルトのパスを上書きしないでください：PHPのデフォルトのinclude_pathを簡単に上書きしないでください。そうしないと、他のシステムファイルの読み込みに影響を与える可能性があります。完全に交換する代わりに、 get_include_path（）を介して現在のパスを取得し、新しいパスを追加できます。
絶対パスを使用する：相対パスによって引き起こされるエラーを回避するために、絶対パスを使用してみてください。相対パスはより便利ですが、場合によっては、絶対パスはパスの問題によって引き起こされる問題を減らすことができます。
ini_set（）を使用してinclude_pathを一時的に変更します。
<span><span><span class="hljs-title function_ invoke__">ini_set</span></span><span>(</span><span><span class="hljs-string">'include_path'</span></span><span>, </span><span><span class="hljs-string">'/path/to/your/library'</span></span><span>);
</span></span>この方法で設定されたパスは、現在のスクリプトに対してのみ有効であり、スクリプトが終了した後、他のスクリプトには影響しません。
SET_INCLUDE_PATH（）はサードパーティライブラリをロードする効率的な方法ですが、現在、より多くのPHP開発者が作曲家を使用してライブラリと依存関係を管理する傾向があります。 Composerはオートローダー機能を提供し、付属のパスを手動で設定する必要はなくなりました。 Composerを介してライブラリをインストールするだけで、自動的にパスを設定し、適切なAutoLoadファイルを生成します。
<span><span>composer require vendor/package-name
</span></span>次に、PHPファイルで、ComposerのAutoLoadファイルをインポートするだけです。
<span><span><span class="hljs-keyword">require_once</span></span><span> </span><span><span class="hljs-string">'vendor/autoload.php'</span></span><span>;
</span></span>Composerは、必要なすべての依存関係を自動的にロードし、手動でパスの構成の累積性を回避します。
SET_INCLUDE_PATH（）関数を使用してサードパーティライブラリをロードすることは、場合によっては非常に便利なトリックです。パスを合理的に設定することにより、PHPがライブラリファイルを正しくロードし、パスエラーによるデバッグの問題を減らすことができるようにします。ただし、最新のPHP開発ツールの人気により、Composerを使用してライブラリを自動的にロードすることが、より効率的で推奨される方法になりました。 Composerを試していない場合は、それを学んで使用することを強くお勧めします。これにより、手動の構成で多くのトラブルを節約できます。
