Split php/python

content/doc/applications/php/_index.md

@@ -0,0 +1,218 @@
+---
+type: docs
+linkTitle: PHP with Apache
+title: PHP with Apache application runtime
+description: Deploy PHP applications on Clever Cloud with Apache, PHP-FPM, Composer dependencies, and framework support
+keywords:
+- php hosting
+- apache
+- composer
+- laravel
+- symfony
+- wordpress
+aliases:
+- /applications/php
+- /deploy/application/php/php-apps
+- /doc/deploy/application/php
+- /doc/deploy/application/php/php-apps
+- /doc/doc/php
+- /doc/php
+- /doc/php/php-apps
+- /doc/doc/php/php-apps
+- /doc/getting-started/by-language/php
+- /doc/partials/language-specific-deploy/php
+- /getting-started/by-language/php
+- /php
+- /php/php-apps
+---
+
+## Overview
+
+PHP is a widely-used general-purpose scripting language that is especially suited for Web development and can be embedded
+into HTML.
+
+The HTTP server is [Apache 2](https://httpd.apache.org/), and the PHP code is executed by [PHP-FPM](https://php-fpm.org/).
+
+## Create your PHP application
+
+To create a new PHP application, use the [Clever Cloud Console](https://console.clever-cloud.com) or [Clever Tools](https://github.com/CleverCloud/clever-tools):
+
+```bash
+clever create --type php
+```
+- [Learn more about Clever Tools](/doc/cli/)
+- [Learn more about Clever Cloud application deployment](/doc/quickstart/#create-an-application-step-by-step)
+
+## Configure your PHP application
+
+### Mandatory needs
+
+PHP runtime requires a working web application. The HTTP server is Apache 2 with PHP-FPM. If you need to serve files from a specific directory, set the `CC_WEBROOT` environment variable (e.g. `/public`).
+
+```shell
+clever env set CC_WEBROOT /public
+```
+
+- [Learn more about environment variables on Clever Cloud](/doc/reference/reference-environment-variables/)
+
+### Build phase
+
+Composer build is supported out of the box. If a `composer.json` file is present at the root of your repository, dependencies are installed automatically during the build phase.
+
+- [Learn more about Composer on Clever Cloud](/doc/applications/php/composer/)
+- [Learn more about Deployment hooks](/doc/develop/build-hooks/)
+
+### PHP version
+
+Set the `CC_PHP_VERSION` environment variable to one of the following versions.
+
+{{< runtimes_versions php >}}
+
+All new PHP applications are created with a default `CC_PHP_VERSION`. You can change it whenever you want then redeploy your application to use the version you want. Only values based on the first two digits (`X` or `X.Y`, not `X.Y.Z`) are supported.
+
+### Custom PHP configuration
+
+Most PHP settings can be changed using a `.user.ini` file.
+
+If you want the settings to be applied to the whole application, you should put this file in your `webroot`. If you did not change it, then your `webroot` is the root of the repository.
+
+If you put the `.user.ini` file in a subdirectory, settings will be applied recursively starting from this subdirectory.
+
+You can review the [available directives](https://www.php.net/manual/en/ini.list.php); all the `PHP_INI_USER`, `PHP_INI_PERDIR`, and `PHP_INI_ALL` directives can be set from within `.user.ini`.
+
+- [Learn more about .user.ini](https://www.php.net/manual/en/configuration.file.per-user.php)
+
+#### Same configuration between PHP-CLI and PHP-FPM
+
+`.user.ini` files are not loaded by the PHP CLI by default.
+
+However, some PHP applications may want to check for the PHP-FPM configuration pre-requisites, `post_max_size` or `upload_max_filesize` values for example.
+
+To load the PHP-FPM `.user.ini` file during a PHP-CLI process, in a [hook](/doc/develop/build-hooks/), use the `PHP_INI_SCAN_DIR` environment variable to load the additional file.
+
+Assuming the script runs at the root-folder of the application:
+
+```bash
+#!/usr/bin/env bash
+
+export PHP_INI_SCAN_DIR=":."
+php myscript.php
+```
+
+This appends the current directory while still loading the default configuration.
+
+> [!NOTE]
+> The `:` at the beginning of the string is mandatory. It indicates defaults files must still load.
+
+A specific `.ini` file can be loaded with:
+
+```bash
+#!/usr/bin/env bash
+
+export PHP_INI_SCAN_DIR=":.php-configuration/"
+php myscript.php
+```
+
+This loads every `.ini` files in the `php-configuration/` directory.
+
+#### Timezone configuration
+
+All instances on Clever Cloud run on the UTC timezone. We recommend to handle all your dates in UTC internally, and only handle timezones when reading or displaying dates.
+
+Additionally, you can set PHP's time zone setting with `.user.ini`. For instance, to use the french time zone, edit `.user.ini` to add this line:
+
+```ini
+date.timezone=Europe/Paris
+```
+
+#### Memory Limit
+
+When php-fpm spawns a worker it allocates a smaller part of the application's memory to the worker, here is the allocated memory for each flavor:
+
+ | Flavor   | Memory Limit |
+ |----------|--------------|
+ |Pico      | 64M          |
+ |Nano      | 64M          |
+ |XS        | 128M         |
+ |S         | 256M         |
+ |M         | 384M         |
+ |L         | 512M         |
+ |XL        | 768M         |
+ |2XL       | 1024M        |
+ |3XL       | 1536M        |
+ |4XL+      | 2048M        |
+
+To change this limit you can define `MEMORY_LIMIT` [environment variable](/doc/reference/reference-environment-variables#php).
+
+If you define a limit exceeding the application memory it will use the default one.
+
+## Frameworks and CMS
+
+The following is the list of tested CMS by our team.
+
+It's quite not exhaustive, so it does not mean that other CMS can't work on the Clever Cloud platform.
+
+{{< cards >}}
+  {{< card link="/developers/guides/tutorial-drupal" title="Drupal" subtitle= "Deploy a Drupal-based website on Clever Cloud" icon="drupal" >}}
+  {{< card link="/developers/guides/tutorial-laravel" title="Laravel" subtitle= "Deploy a Laravel app on Clever Cloud" icon="laravel" >}}
+  {{< card link="/developers/guides/tutorial-symfony" title="Symfony" subtitle= "Deploy a Symfony application on Clever Cloud" icon="symfony" >}}
+  {{< card link="/developers/guides/tutorial-wordpress" title="WordPress" subtitle= "Deploy WordPress on Clever Cloud" icon="wordpress" >}}
+  {{< card link="/developers/guides/moodle" title="Moodle" subtitle="Full Moodle installation and configuration guide" icon="moodle" >}}
+
+{{< /cards >}}
+
+Others PHP frameworks tested on Clever Cloud:
+
+- Prestashop
+- Dokuwiki
+- Joomla
+- SugarCRM
+- Drupal
+- Magento
+- Status.net
+- Symfony
+- Thelia
+- Laravel
+- Sylius
+
+## Configure Monolog
+
+A lot of frameworks (including Symfony) use Monolog to handle logging. The default configuration of Monolog doesn't allow to log errors into the console.
+
+Here is a basic configuration of Monolog to send your application's logs into our logging system and access them into the Console:
+
+```yaml
+monolog:
+  handlers:
+    clever_logs:
+      type: error_log
+      level: warning
+```
+
+You can change the level to whatever level you desire. For Symfony, the configuration file is `app/config/config_prod.yml`.
+
+Laravel doesn't need Monolog to retrieve logs via Clever console or Clever CLI. Here, ensure that you have the following line in `config/app.php`:
+
+```php
+return [
+    // …
+    'log' => env('APP_LOG'),
+    // …
+];
+```
+
+Then, set `APP_LOG=syslog` as Clever application environment variable.
+
+{{% content "new-relic" %}}
+
+{{% content "blackfire" %}}
+
+## ProxySQL
+
+{{% content "proxysql" %}}
+
+You can learn more about ProxySQL on the [dedicated documentation page](/guides/proxysql)
+
+{{% content "url_healthcheck" %}}
+{{% content "redirectionio" %}}
+{{% content "varnish" %}}

content/doc/applications/php/apache.md

@@ -0,0 +1,121 @@
+---
+type: docs
+linkTitle: Apache
+title: Apache web server configuration
+description: Configure Apache 2 for PHP applications on Clever Cloud with htaccess, authentication, HTTPS redirection, and FastCGI settings
+keywords:
+- apache
+- htaccess
+- htpasswd
+- fastcgi
+- https redirect
+---
+
+## Configure Apache
+
+Apache 2 is used as HTTP Server for PHP applications on Clever Cloud. You can configure it with `.htaccess` files and environment variables.
+
+### htaccess
+
+The `.htaccess` file can be created everywhere in your app, depending of the part of the application covered by directives.
+
+However, directives who applies to the entire application must be declared in a `.htaccess` file to the application root.
+
+### Basic authentication
+
+You can configure basic authentication using [environment variables](/doc/reference/reference-environment-variables#php). You will need to set `CC_HTTP_BASIC_AUTH` variable to your own `login:password` pair. If you need to allow access to multiple users, you can create additional environment `CC_HTTP_BASIC_AUTH_n` (where `n` is a number) variables.
+
+### HTTP timeout
+
+You can define the timeout of an HTTP request in Apache using the `HTTP_TIMEOUT` [environment variable](/doc/develop/env-variables).
+
+**By default, the HTTP timeout is set to 3 minutes (180 seconds)**.
+
+### Header size
+
+Default Apache header size is `8k`. If you need to increase it, you can set `CC_APACHE_HEADERS_SIZE` environment variable, between `8` and `256`. Effective value depends on deployment region. [Ask for a dedicated load balancer](https://console.clever-cloud.com/ticket-center-choice) for a specific value.
+
+### Force HTTPS traffic
+
+Load balancers handle HTTPS traffic ahead of your application. You can use the `X-Forwarded-Proto` header to know the original protocol (`http` or `https`).
+
+Place the following snippet in a `.htaccess` file to ensure that your visitors only access your application through HTTPS.
+
+```conf
+RewriteEngine On
+RewriteCond %{HTTPS} off
+RewriteCond %{HTTP:X-Forwarded-Proto} !https
+RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
+```
+
+### Prevent Apache to redirect HTTPS calls to HTTP when adding a trailing slash
+
+`DirectorySlash` is enabled by default on the PHP scalers, therefore Apache will add a trailing slash to a resource when it detects that it is a directory.
+
+E.g. if foobar is a directory, Apache will automatically redirect `http://example.com/foobar` to `http://example.com/foobar/`.
+
+Unfortunately the module is unable to detect if the request comes from a secure connection or not. As a result it will force an HTTPS call to be redirected to HTTP.
+
+In order to prevent this behavior, you can add the following statements in a `.htaccess` file:
+
+```conf
+DirectorySlash Off
+RewriteEngine On
+RewriteCond %{REQUEST_FILENAME} -d
+RewriteRule ^(.+[^/])$ %{HTTP:X-Forwarded-Proto}://%{HTTP_HOST}/$1/ [R=301,L,QSA]
+```
+
+These statements will keep the former protocol of the request when issuing the redirect. Assuming that the header `X-Forwarded-Proto` is always filled (which is the case on our platform).
+
+If you want to force all redirects to HTTPS, you can replace `%{HTTP:X-Forwarded-Proto}` with `https`.
+
+### Change the FastCGI module
+
+You can choose between two FastCGI modules, `fastcgi` and `proxy_fcgi`, using the `CC_CGI_IMPLEMENTATION` environment variable. If you don't set it `proxy_fcgi` is used as default value. `proxy_fcgi` is recommended, as `fastcgi` implementation is not maintained anymore.
+
+If you have issues with downloading content, it could be related to the `fastcgi` module not working correctly in combination with the `deflate` module, as the `Content-Length` header is not updated to the new size of the encoded content. To resolve this issue, use `proxy_fcgi`.
+
+## Header injection
+
+### With .htaccess
+
+To inject headers on HTTP responses, add this configuration to `.htaccess` file:
+
+```sh
+Header Set Access-Control-Allow-Origin "https://www.example.com"
+Header Set Access-Control-Allow-Headers "Authorization"
+```
+
+> [!NOTE]
+> You can use a `.htaccess` file to create or update headers, but you can't delete them.
+
+### With PHP
+
+You can also do it from PHP:
+
+```php
+header("Access-Control-Allow-Origin: https://www.example.com");
+header("Access-Control-Allow-Headers: Authorization");
+```
+
+If you want to keep this separate from your application, you can configure the application to execute some code on every request.
+
+In `.user.ini`, add the following line (you need to create `inject_headers.php` first):
+
+```ini
+auto_prepend_file=./inject_headers.php
+```
+
+- [Learn more about .user.ini directives](https://www.php.net/manual/en/configuration.file.per-user.php)
+
+## Using HTTP authentication
+
+Using basic HTTP authentication, PHP usually handles the values of user and password in variables named `$_SERVER['PHP_AUTH_USER']` and `$_SERVER['PHP_AUTH_PW']`.
+
+At Clever Cloud, an Apache option is enabled to pass directly the Authorization header, even though FastCGI is used; still, the header is not used by PHP, and the aforementioned variables are empty.
+
+You can do this to fill them using the Authorization header:
+
+```php
+list($_SERVER['PHP_AUTH_USER'], $_SERVER['PHP_AUTH_PW']) = explode(':' , base64_decode(substr($_SERVER['Authorization'], 6)));
+```