# Setting the PHP include path

> Tell PHP where to find included files and libraries such as PEAR using cPanel, php.ini, set_include_path() or .htaccess.

Source: https://helpcenter.ruachost.com/developers/php/setting-the-php-include-path/

The **PHP include path** tells PHP where to look for files when using functions like `include()` and `require()`. By configuring the include path, you can centralize commonly used code and ensure PHP can locate libraries such as **PEAR**. On **ruachost.com**, you can set the include path in several ways.

## Why Set the Include Path?

- Centralize reusable code (e.g., libraries, configuration files).
- Ensure PHP can locate external packages like PEAR.
- Improve maintainability by avoiding long relative paths.
- Enhance security by keeping sensitive files outside `public_html`.

## Methods to Set the Include Path

### Method 1: Use the PHP Selector in cPanel

1. Log in to **cPanel**.
2. Go to **Software → Select PHP Version**.
3. Click the **Options** tab.
4. Locate the `include_path` option.
5. Enter your desired path (separate multiple directories with a colon `:`). Example:

   ```
   .:/home/username/include
   ```
6. Changes take effect immediately.

### Method 2: Use a Custom php.ini File

1. Create or edit a `php.ini` file in your account.
2. Add the following line (replace `username` and `include_directory`):

   ```
   include_path = ".:/home/username/include_directory"
   ```
3. Save the file.
4. PHP will now use this include path for scripts in that directory.

### Method 3: Use the set_include_path() Function

Set the include path directly in a PHP script:

```
<?php
set_include_path(".:/usr/lib/php:/usr/local/lib/php:/home/username/php");
?>
```

- Effective only for the duration of the script’s execution.
- Does not affect other scripts.

### Method 4: Use the .htaccess File

If PHP runs as an Apache module, you can set the include path in `.htaccess`:

```
php_value include_path ".:/path/to/include"
```

- Place this in your site’s root `.htaccess` file.
- Effective for all scripts in that directory.

> **Best Practices:**
- Place include directories **outside** `public_html` to prevent public access.
- Use absolute paths for reliability.
- Test changes with a simple script to confirm PHP can locate files.