arch-wiki-md-repo/wiki/_content/english/Suphp.md

All arch-wiki articles in markdown format, updated every two days.

[suPHP](http://www.suphp.org/Home.html) is a tool *for executing PHP scripts with the permissions of their owners*. It consists of an Apache module (mod_suphp) and a setuid root binary (suphp) that is called by the Apache module to change the uid of the process executing the PHP interpreter.

**Tip:** With suPHP you are able, for example, to manage php applications in user's home directories without worry about permissions problems (when creating directories, files or uploads)

## Contents

*   [1 Installation](#Installation)
*   [2 Configuration](#Configuration)
*   [3 Additional information](#Additional_information)
*   [4 suPHP and mod_php](#suPHP_and_mod_php)
    *   [4.1 suPHP in user directories](#suPHP_in_user_directories)
*   [5 See also](#See_also)

### Installation

Install suPHP from the [Arch User Repository](/index.php/Arch_User_Repository "Arch User Repository"): [suphp](https://aur.archlinux.org/packages/suphp/)

### Configuration

To activate **mod_suphp** for the appropriate Virtual Hosts add a line like in your `/etc/http/conf/**http.conf**` file:

 `/etc/http/conf/http.conf` 
```
#suPHP
LoadModule suphp_module modules/mod_suphp.so

```

To use suPHP to parse PHP-Files you must add also this:

 `/etc/http/conf/http.conf` 
```
 AddType application/x-httpd-php .php

```

Then, for actually turn on **mod_suphp** add this line:

 `/etc/http/conf/http.conf` 
```
 suPHP_Engine on

```

Finally, you have to specify at least one **suPHP_AddHandler** directive, because **mod_suphp** by default handles no mime-type.

 `/etc/http/conf/http.conf` 
```
suPHP_AddHandler application/x-httpd-php

```

Finally your suPHP installation is complete. Before start using it you need to restart your HTTPd server by following command:

```
# systemctl restart httpd

```

**Note:** If these changes are made in global Apache-configuration file, this will activate **mod_suphp** for all Virtual Hosts..

### Additional information

Please note, that running mod_suphp and mod_php concurrently should be avoided. The same applies to CGI scripts which are run with webserver privileges.

suPHP should only be used if you are using no CGI scripts or if all CGI scripts are run using suExec.

**Warning:** If you use suPHP module instead of mod_php (php-apache) one, you won't be able to use phpMyadmin and some other applications because incompatibilities with php-cgi interpeter.

## suPHP and mod_php

In order to use suPHP along side mod_php (for use phpMyAdmin for instance). The only way to go is configure suPHP and mod_php in differents Virtual Hosts or Directories.

### suPHP in user directories

The following instructions intent to show how to configure suPHP just to work in users public_html directories and mod_php for everything else.

First of all, you need to change the suPHP handler name to avoid confilcts with php_module. Change this line in `/etc/suphp/**suphp.conf**`

 `/etc/suphp/suphp.conf` 
```
[handlers]
;Handler for php-scripts
application/x-httpd-**su**php="php:/usr/bin/php-cgi"

```

Add or modify this line in your `/etc/http/conf/**http.conf**` file:

 `/etc/http/conf/http.conf` 
```
#suPHP
LoadModule suphp_module modules/mod_suphp.so

```

Then, in order to set the suPHP module for user directories, add this to your `/etc/http/conf/extra/**http-userdir.conf**` file:

 `/etc/httpd/conf/extra/httpd-userdir.conf` 
```
<Directory "/home/*/public_html">
...
    DirectoryIndex index.php index.html
    suPHP_Engine on
    AddHandler application/x-httpd-suphp .php
    suPHP_AddHandler application/x-httpd-suphp
...
</Directory>

```

Finally you need to restart your HTTPd server by following command:

```
# systemctl restart httpd

```

## See also

*   [MySQL](/index.php/MySQL "MySQL") - Article for MySQL
*   [LAMP](/index.php/LAMP "LAMP") - Guide to setting up Apache, MySQL, and PHP.
*   [PhpMyAdmin](/index.php/PhpMyAdmin "PhpMyAdmin") - Web frontend for MySQL typically found in LAMP environments
*   [Adminer](/index.php/Adminer "Adminer") - A full-featured database management tool which is available for MySQL, PostgreSQL, SQLite, MS SQL and Oracle
*   [XAMPP](/index.php/XAMPP "XAMPP") - Self contained web-server that supports PHP, Perl, and MySQL
*   [mod_perl](/index.php/Mod_perl "Mod perl") - Apache + Perl