Troubleshooting PrestaShop 9 Local Installation: Common Errors & Solutions

Troubleshooting PrestaShop 9 Local Installation: Common Errors & Solutions

Setting up PrestaShop locally is a fundamental step for development and testing. However, users often encounter configuration challenges that can halt the installation process. This community insight, inspired by a PrestaShop forum thread, addresses common errors faced during PrestaShop 9 local installation and provides actionable solutions.

The Problem: Renaud01's PrestaShop 9 Local Setup Hurdles

A user, renaud01, sought help after encountering multiple errors during a PrestaShop 9 local installation. The key issues reported were:

  • "L'extension Fileinfo n'est pas activée" (Fileinfo extension not activated)
  • "Tous les fichiers n'ont pas été mis en ligne sur votre serveur" (All files not uploaded to your server)
  • "To get the latest internationalization data upgrade the ICU system package and the intl PHP extension."
  • "Setting "realpath_cache_size" to e.g. "5242880" or "5M" in php.ini* may improve performance on Windows significantly in some cases."

Despite initial attempts, renaud01 confirmed that most of these issues persisted, highlighting a common need for clear troubleshooting steps.

Expert Solutions for PrestaShop Local Installation Errors

These errors are typically related to PHP configuration or file integrity. Here’s how to systematically address them:

1. Activating the Fileinfo PHP Extension

The

Fileinfo
extension is vital for PrestaShop to correctly identify file types, crucial for secure uploads and media handling. If it's disabled, you'll see the "Fileinfo extension not activated" error.

  • Solution: Locate your
    php.ini
    file (e.g., in XAMPP, WAMP, MAMP, or your custom PHP setup). Open it with a text editor. Find the line
    ;extension=fileinfo
    and remove the semicolon (;) to enable it:
    extension=fileinfo
    . Save the file and restart your web server (Apache, Nginx, etc.) for the change to take effect.

2. Resolving "All Files Not Uploaded to Your Server"

This message often indicates issues beyond literal file uploads, such as corrupted downloads, incomplete extractions, or incorrect file permissions.

  • Solution 1: Re-download and Re-extract: A corrupted or incomplete PrestaShop installation package is a frequent culprit. Download the latest stable version of PrestaShop 9 from the official website (prestashop.com/en/download) and re-extract it into your local web server's root directory (e.g.,
    htdocs
    ).
  • Solution 2: Check File Permissions: Incorrect permissions can prevent PrestaShop from writing necessary files. Ensure directories are set to
    755
    and files to
    644
    . For specific folders like
    img
    ,
    cache
    ,
    themes/yourtheme/cache
    ,
    config
    , and
    log
    , you might temporarily use
    777
    during installation if
    755
    doesn't suffice, but revert to more secure settings immediately after.

3. Upgrading ICU System Package and intl PHP Extension

The

intl
(Internationalization Functions) PHP extension, powered by the ICU library, is essential for PrestaShop's multi-language and locale-aware features. An outdated or disabled
intl
can cause internationalization data warnings.

  • Solution: In your
    php.ini
    file, find and uncomment
    ;extension=intl
    to make it
    extension=intl
    . On Linux systems, you might also need to install the
    php-intl
    package via your package manager (e.g.,
    sudo apt-get install php-intl
    ). Always restart your web server after modifying
    php.ini
    .

4. Optimizing realpath_cache_size for Windows Performance

This is a performance recommendation, especially beneficial for Windows development environments. Increasing

realpath_cache_size
improves file path resolution, leading to better performance.

  • Solution: In
    php.ini
    , set
    realpath_cache_size = 5M
    (or
    5242880
    ). Restart your web server to apply the change.

Conclusion: A Foundation for Smooth PrestaShop Development

Renaud01's experience highlights that successful PrestaShop local installation relies on meticulous PHP environment configuration. By systematically addressing PHP extension activations, verifying file integrity, and optimizing performance settings, developers and merchants can ensure a smooth PrestaShop 9 setup. Always consult official PrestaShop documentation and confirm your local environment meets the minimum technical requirements for your chosen PrestaShop version.

Start with the tools

Explore migration tools

See options, compare methods, and pick the path that fits your store.

Explore migration tools