AppleAutoPro Docs

English

简体中文

English

简体中文

Appearance

AppleAutoPro Frontend Installation Guide ​

🌟 Introduction ​

This guide provides step-by-step instructions for deploying and configuring the AppleAutoPro frontend.

⚙️ 1. Requirements ​

  • PHP: Version 8.2 or above
  • Database: MySQL 5.7+ or MariaDB
  • Cache: Redis

You can use aaPanel to manage your server environment.

🚨 2. Important Notes ​

  • Follow each step carefully; resolve any errors before proceeding.

📥 3. Download and Configure the Program ​

  1. Get the Source Code: Download and extract to the website root directory.
  2. Set Configuration Files:
    • Copy .example.env to .env and fill in the necessary configurations.
  3. Configure PHP Environment:
    • Remove putenv and proc_open from disabled functions.
    • Install extensions: fileinfo, ioncube, redis.

aaPanel Configuration Example: ​

  • Go to Software Store → PHP8.x Settings
  • Delete putenv, proc_open from disabled functions.
  • Install fileinfo, ioncube, and redis extensions.

🔧 4. Upgrade to the Latest ionCube Extension ​

Note: You can run php -v to check your ionCube Loader version. If it’s below 14.0, please follow these steps.

  1. Open your PHP configuration file (in aaPanel: Software Store → PHP 8.x Settings → Configuration) and search for zend_extension to confirm it’s loaded:

    ini
    zend_extension = "/usr/local/ioncube/ioncube_loader_lin_8.x.so"

  2. Visit the official ionCube download page: https://www.ioncube.com/loaders.php

  3. Download the ioncube_loader_lin_8.x.so file that matches your server OS and PHP 8.x version.

  4. Extract and upload the file to the directory specified in your PHP configuration (e.g., /usr/local/ioncube/), replacing the old file.

  5. Restart PHP to apply the changes

  6. Verify that ionCube v14 is successfully loaded:

    bash
    php -v

💻 5. Install Dependencies (Composer) ​

bash
wget https://getcomposer.org/installer -O composer.phar
php composer.phar
php composer.phar install

🌐 6. Set Website Directory and Nginx Rules ​

  1. Set Website Root Directory: /public
  2. Nginx Rewrite Rules:
nginx
location ~* (runtime|application)/{    
    return 403;
}
location / {
    if (!-e $request_filename){
        rewrite  ^(.*)$  /index.php?s=$1  last;   break;
    }
}

🗄️ 7. Import Database ​

bash
php think migrate:run

Ensure .env database settings are correct.

🧑‍💻 8. Register Administrator Account ​

bash
php think register <email> <username> <password>

Replace placeholders without angle brackets.

🛡️ 9. Set File Permissions ​

  • Set directory permissions to 755, owner to www.
  • aaPanel Example:
    • Navigate to website directory → Permissions
    • Set permission 755 and owner to www
    • Apply to subdirectories.

✅ 10. Complete Installation and Verify ​

  1. Visit your website to confirm functionality.
  2. Log in to the admin panel (Admin Panel → System Settings) and review configurations.
  3. Ensure backend deployments are complete.

⏰ 11. Scheduled Task ​

Set up a scheduled task to run every 1 minute:

bash
php /www/wwwroot/AppleAutoPro/think cronJob

Note: Please adjust /www/wwwroot/AppleAutoPro to your actual installation path.

💾 12. Data Backup and Recovery ​

To ensure data security, it is recommended to backup the database regularly. AppleAutoPro provides multiple backup and recovery methods.

For detailed backup and recovery instructions, please refer to: Data Backup and Recovery

🎉 AppleAutoPro Frontend Installation Completed!