downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | conferences | my php.net

search for in the

set_magic_quotes_runtime> <restore_include_path
[edit] Last updated: Fri, 17 May 2013

view this page in

set_include_path

(PHP 4 >= 4.3.0, PHP 5)

set_include_pathinclude_path yönergesinin çalışma anı değerini belirler

Açıklama

string set_include_path ( string $yeni_değer )

include_path yönergesinin, betiğin çalışma süresince geçerli olacak değerini belirler.

Değiştirgeler

yeni_değer

include_path yönergesini yeni değeri.

Dönen Değerler

Başarısızlık durumunda FALSE, aksi takdirde include_path yönergesinin eski değeriyle döner.

Örnekler

Örnek 1 - set_include_path() örneği

<?php
// PHP 4.3.0 ve sonrasında çalışır
set_include_path('/inc');

// PHP'nin tüm sürümlerinde çalışır
ini_set('include_path''/inc');
?>

Örnek 2 - İçerilecek dosyaların aranacağı yollara bir yenisini eklemek

PATH_SEPARATOR sabitini kullanarak bu yolları işletim sisteminden bağımsız olarak çoğaltmak mümkündür.

Bu örnekte, include_path yönergesinde belirtilen dosya yollarına /usr/lib/pear dizinini ekleyeceğiz.

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

Ayrıca Bakınız



set_magic_quotes_runtime> <restore_include_path
[edit] Last updated: Fri, 17 May 2013
 
add a note add a note User Contributed Notes set_include_path - [12 notes]
up
1
chris-r3i
6 years ago
Can be useful to check the value of the constant PATH_SEPARATOR.

<?php
if ( ! defined( "PATH_SEPARATOR" ) ) {
  if (
strpos( $_ENV[ "OS" ], "Win" ) !== false )
   
define( "PATH_SEPARATOR", ";" );
  else
define( "PATH_SEPARATOR", ":" );
}
?>

For older versions of php, PATH_SEPARATOR is not defined.
If it is so, we must check what kind of OS is on the web-server and define PATH_SEPARATOR properly
up
1
df a t dougfelton d o t c o m
8 years ago
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.
up
1
parks at vecinc dot com
3 years ago
If you find that this function is failing for you, and you're not sure why, you may have set your php include path in your sites's conf file in Apache  (this may be true of .htaccess as well)

So to get it to work, comment out any "php_value include_path" type lines in your Apache conf file, and you should be able to set it now in your php code.
up
1
cloxy at cloxy dot com
1 year ago
If you want to include files with their absolute path without changing the current include path, you can use the magic constant __DIR__ . For example:

<?php include(__DIR__.'/file.php'); ?>

It is available since PHP 5.3.
up
0
mateusz at bkfmyjnie dot pl
3 years ago
It seems you can't really set empty inlude_path. First, set_include_path('') does exactly nothing (successfully), and second, '.' is always implicitly appended to the include path by PHP itself, as noted in comments below.

However, you can:
set_include_path(PATH_SEPARATOR); // note no quotes around the PATH_SEPARATOR; it's a string on its own

or, more explicit:
set_include_path('.');

Both seems to have the same result.
up
0
junya at xs4all dot nl
8 years ago
When you use .htaccess to set the include path, don't forget Apache directive 'AllowOverride Options' or 'AllowOverride All' is also needed.
up
-1
koenig at electronova dot net
6 years ago
You can also add several paths in one set_include_path separating them by ':'.
ex : set_include_path('/home/mysite/includes1:/home/mysite/includes2')
up
0
francois r vespa
2 years ago
include_path is not taking in consideration by very commonly used functions such as file_exists(), the following hack can come handy to override that

<?php

function suchFile($file)    // like file_exists() but takes in consideration include_path

{
    if(!
file_exists($file))
   
    {
       
$paths=explode(PATH_SEPARATOR,get_include_path());
       
        foreach(
$paths as $p)
        if(
file_exists(preg_replace('%/$%','',$p)."/$file"))
        return
true;
       
        return
false;
    }
    else
    return
true;
}
?>
up
0
joel at pittet dot ca
2 years ago
Seems set_include_path wasn't working for me.

The problem was i didn't have .:  in my include_path
Which seemed to stop the set_include_path().
up
0
ricardo dot ferro at gmail dot com
5 years ago
Two functions to help:

<?php

function add_include_path ($path)
{
    foreach (
func_get_args() AS $path)
    {
        if (!
file_exists($path) OR (file_exists($path) && filetype($path) !== 'dir'))
        {
           
trigger_error("Include path '{$path}' not exists", E_USER_WARNING);
            continue;
        }
       
       
$paths = explode(PATH_SEPARATOR, get_include_path());
       
        if (
array_search($path, $paths) === false)
           
array_push($paths, $path);
       
       
set_include_path(implode(PATH_SEPARATOR, $paths));
    }
}

function
remove_include_path ($path)
{
    foreach (
func_get_args() AS $path)
    {
       
$paths = explode(PATH_SEPARATOR, get_include_path());
       
        if ((
$k = array_search($path, $paths)) !== false)
            unset(
$paths[$k]);
        else
            continue;
       
        if (!
count($paths))
        {
           
trigger_error("Include path '{$path}' can not be removed because it is the only", E_USER_NOTICE);
            continue;
        }
       
       
set_include_path(implode(PATH_SEPARATOR, $paths));
    }
}

?>
up
-1
r dot s dot goldsmith at far-blue dot co dot uk
8 years ago
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.
up
-2
ChanibaL.net
4 years ago
The files are included in order of the inclusion path, in this example, the directory structure is as follows:
.
|-- index.php
|-- t1
|   |-- a
|   `-- b
`-- t2
    |-- b
    `-- c

<?php

set_include_path
('t1'.PATH_SEPARATOR.'t2');

include
'a'// includes from T1
include 'b'// includes from T1
include 'c'// includes from T2

?>

Note that the include path affects only include/require functions.

<?php

var_dump
(file_exists('a'));  // false
var_dump(fopen('b', 'r'));  // file not found

?>

 
show source | credits | sitemap | contact | advertising | mirror sites