---json
{
    "layout": "median",
    "page_id": "56axulcdjivoxnns79ss1"
}
---
====== ComboStrap - Platform Requirements ======


===== About =====
This articles lists the installation prerequisites of [[:combostrap|ComboStrap]].

===== List =====
==== Php ====

ComboStrap supports the ''php'' version 7.4 up to 8.2.


<note warning>
  * Even if the actual dokuwiki version supports 7.2, our dependencies does not support them anymore because 7.2 is in a [[https://www.php.net/eol.php|End Of Life state]]. You can check the [[https://www.php.net/supported-versions.php|timeline support for the php version]]
  * You can check the [[doku>requirements|Dokuwiki Requirement]]  in the [[https://github.com/splitbrain/dokuwiki/blob/master/.github/workflows/testLinux.yml#L13|Build Ref]] and [[https://github.com/splitbrain/dokuwiki/blob/master/composer.json#L8|Composer Ref]]
</note>
==== Module / Extension ====

ComboStrap uses [[https://www.php.net/manual/en/dom.installation.php|Php DOM]] for [[docs:content:svg|svg]] and [[docs:content:icon|icon]] manipulation.



ComboStrap is dependent on the following php extensions

^ Extension ^ Mandatory ^ Definition ^
| ''pdo_sqlite'' | Yes | Sqlite is the [[docs:analytics:database|database]] |
| ''mbstring'' | Yes | Multi-byte string permits to manage all [[docs:locale:lang|language]] |
| ''openssl'' | Yes | SSL for security reason and message digest |
| ''intl'' | No | the [[https://www.php.net/manual/en/book.intl.php|international module]] is used to retrieve the [[docs:locale:region|country]] of the server if not set. |
| ''gd2'' | Yes | for [[:docs:content:vignette|vignette]] creation and [[docs:content:raster|raster image]] manipulation |
| ''xml'' | Yes | For the [[:docs:performance:svg_optimization|SVG optimization]] |

They should be available on standard php installation, if this is not the case, you can install/configure them

Example:
  * on Windows in the ''php.ini'' file
<code ini php.ini>
[PHP]
extension=pdo_sqlite
extension=mbstring
extension=openssl
extension=intl
extension=gd2
# Xml seems to be included
</code>
  * on Linux
<code bash>
# ubuntu, ...
sudo apt-get install php-xml php-pdo-sqlite php-mbstring php-openssl php-intl php-gd2
# ubuntu 8.1 (The names may need to be adapted to your repo)
sudo apt-get install php8.1-xml php8.1-pdo-sqlite php8.1-mbstring php8.1-openssl php8.1-intl php8.1-gd2
# ubuntu 8.2 (The names may need to be adapted to your repo)
sudo apt-get install php8.2-xml php8.2-pdo-sqlite php8.2-mbstring php8.2-openssl php8.2-intl php8.2-gd2
# centos, redhat
sudo yum install php-xml php-pdo-sqlite php-mbstring php-openssl php-intl php-gd2
</code>


==== Upload Limit ====

Not a requirement but as the default size is only 2M by default,
you may want to change the minimum upload size.


Example:
<code ini php.ini>
upload_max_filesize = 15M
post_max_size = 15M
</code>
where:
  * [[http://php.net/upload-max-filesize|upload_max_filesize]] is the maximum allowed size for uploaded files
  * [[http://php.net/post-max-size|post-max-size]] is the maximum size of POST data