set_include_path

(PHP 4 >= 4.3.0, PHP 5)

set_include_path -- include_path設定オプションをセットする

説明

string set_include_path ( string new_include_path )

スクリプトが動作する間の include_path設定オプションをセットします。成功時に元の include_pathの値を返します。失敗するとFALSEを返します。

例 1. set_include_path()の例

<?php // PHP 4.3.0 で動作する set_include_path('/inc'); // すべての PHP のバージョンで動作する ini_set('include_path', '/inc'); ?>

例 2. include path を追加する
PATH_SEPARATOR 定数を利用することで、オペレーティングシステムに依存せずに include path を追加することが可能です。
この例では、既存の include_path の最後に /usr/lib/pear を追加します。

<?php $path = '/usr/lib/pear'; set_include_path(get_include_path() . PATH_SEPARATOR . $path); ?>

ini_set(), get_include_path(), restore_include_path(), include()も参照してください。

add a note User Contributed Notes
set_include_path

huuanito at hotmail dot com
16-Jan-2007 10:18


Just a note on koenig at electronova dot net's post:

to be OS independent you'd use  '.PATH_SEPARATOR.' 

in place of :

marc dot jaeger at ti dot ch
04-Dec-2006 07:10


Not shure if it is possible to use wildchars when setting include_path in php.ini [for example include_path=.:/usr/lib/php:/home/*/includes ].

koenig at electronova dot net
03-Oct-2006 01:24


You can also add several paths in one set_include_path separating them by ':'.

ex : set_include_path('/home/mysite/includes1:/home/mysite/includes2')

junya at xs4all dot nl
28-Jan-2005 10:41


When you use .htaccess to set the include path, don't forget Apache directive 'AllowOverride Options' or 'AllowOverride All' is also needed.

df a t dougfelton d o t c o m
26-Jan-2005 12:37


In order to use .htaccess files to set the include path, PHP must be installed as an Apache module. If PHP is compiled as a CGI binary, you can set the include path in a custom php.ini file (if, for example, you're being hosted somewhere and don't have access to the main php.ini file.  Note that custom php.ini files don't affect subdirectories in the way that .htaccess files do, so you'll need to put your custom php.ini file in any subdirectories as well.

Robin Millette at http://rym dot waglo dot com/
13-Dec-2004 11:54


Since the path separator is platform dependant, PHP provides the PATH_SEPARATOR magic constant, showing up as a colon ( : ) on this GNU/Linux machine.

r dot s dot goldsmith at far-blue dot co dot uk
08-Dec-2004 08:23


If you want to set the paths php uses to find included files on a directory by directory level, you can do so in Apache's .htaccess file. Add the line:



php_value include_path  "<first path to look>:<second path>:<etc>:."



to the .htaccess file. This will replace any paths set in your environment or the php.ini file so remember to include the path to php's own libraries as, usually, the first option!



V.useful tip given to me by the 'php guy' at Edinburgh Uni's Computing Support.

add a note

set_magic_quotes_runtime

" width="11" height="7"/>

restore_include_path

Last updated: Wed, 01 Nov 2006