> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://doc.common-services.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Information tab — common errors

The Mirakl module **Information** tab checks PHP and PrestaShop.  
**Red** alerts often block the module; **yellow** ones are recommendations.

If a message is not listed here: [Contact](https://doc.common-services.com/en/article/contact-yuxwdc/).

---

## PHP requirements (blocking)

### cURL missing

Message:

> PHP cURL must be installed on this server. The module require the cURL library and can't work without

**Why:** the module calls the Mirakl API via cURL. Without this PHP extension, there is no marketplace connection.

**What to do:** ask your host to enable the **php-curl** extension, then reload the Information tab.

---

### DOMDocument / XML missing

Message:

> PHP DOMDocument (XML Library) must be installed on this server.
> The module require this library and can't work without

**Why:** reading / generating XML data (feeds, API responses in some cases).

**What to do:** enable the PHP **xml** / **dom** extension (often `php-xml`).

---

### parse_ini_file() disabled

Message:

> PHP function: parse_ini_file() must be enabled on this server.
> The module requires this function and can not work without it.

**Why:** the module reads internal configuration files. If `parse_ini_file` is in `disable_functions`, it breaks.

**What to do:** host → remove `parse_ini_file` from `disable_functions` (php.ini / hosting panel).

---

### Export folder permissions

Message:

> You have to set write permissions to the %s directory and its subsequents files

(`%s` = path such as `…/modules/mirakl/export`)

You may also see:

> The export directory is not writeable... please fix permissions  
> Unable to create output directory

**Why:** the module writes export files (offers, etc.) under `modules/mirakl/export`. Without write access → export fails.

**What to do:** [Write permissions issue](https://doc.common-services.com/en/article/write-permissions-issue-1j105bh/).

---

## Time / memory limits (recommended)

### max_execution_time too low

Message:

> PHP value: max_execution_time recommended value is at least 120. your limit is currently set to %d

**Why:** exporting or importing many orders can exceed 30–60 s. PHP then stops the script (timeout, [white screen](https://doc.common-services.com/en/article/white-screen-yud5rz/), incomplete export).

**What to do:** ask for **≥ 120** (often 180–300 on large catalogs). On shared hosting, if that is not possible: export in smaller batches ([Export offers](https://doc.common-services.com/en/article/export-offers-7dacds/)).

---

### memory_limit too low

Message:

> PHP value: memory_limit recommended value is at least %sMB. your limit is currently set to %sMB.

The module warning threshold is **128 MB**.

**Why:** loading the catalog, images, and profiles uses RAM. Below the limit → out-of-memory error, export interrupted.

**What to do:** raise to **128 MB** minimum; **256 MB** or more for a large catalog. Limited shared hosting → reduce volume or upgrade the plan.

---

## Other PHP limits (recommended)

### suhosin / max_vars

Message:

> PHP value: suhosin/max_vars could trouble your module configuration

**Why:** Suhosin caps POST variables. The configuration tab ([Profiles](https://doc.common-services.com/en/article/profiles-16bb40d/), [Categories](https://doc.common-services.com/en/article/categories-1gpry2n/), mapping…) sends many fields: some can be **dropped** on save without a clear error.

**What to do:** host → increase `suhosin.post.max_vars` and `suhosin.request.max_vars` (often ≥ 3000–5000). The module warns below **1000**.

---

### max_input_vars too low

Message:

> PHP value: max_input_vars could trouble your module configuration

**Why:** same idea as Suhosin, with standard PHP. Configuration saved **incompletely** (categories / profiles missing).

**What to do:** increase `max_input_vars` (often ≥ 3000–5000). Module warns if < **1000**.

---

## PrestaShop

### Maintenance mode

Message:

> Be careful, your shop is in maintenance mode, the module might not work in that mode

**Why:** some module requests go through the shop / front. In maintenance they fail or behave incorrectly (export, AJAX, cron).

**What to do:** turn maintenance off while testing and syncing (or allow your IP if PrestaShop supports it).

---

## AJAX / server errors

On **Catalog → Mirakl** (export), when AJAX fails the message is:

> A server-side error has occured. Please contact your server administrator, hostmaster or webmaster

**Why:** back-office URL ≠ shop domain, host blocking, permissions, PHP timeout/memory, storefront unreachable, etc.

**What to do:** [AJAX script execution failed / server-side error](https://doc.common-services.com/en/article/ajax-script-execution-failed-server-side-error-1ez840o/).

---

## Next

[Write permissions issue](https://doc.common-services.com/en/article/write-permissions-issue-1j105bh/), [White screen](https://doc.common-services.com/en/article/white-screen-yud5rz/), [Contact](https://doc.common-services.com/en/article/contact-yuxwdc/), [First go-live checklist](https://doc.common-services.com/en/article/checklist-first-use-zazvh7/)