BeikeShop Official Website: beikeshop.com

BeikeShop is a premier open-source e-commerce system built on the Laravel framework. Specifically designed for cross-border trade, it offers a fully customizable, multi-language, and multi-currency solution for businesses looking to scale their independent global storefronts.

Introduction

In the release of BeikeShop v2.0, we have made significant optimizations in system architecture and user experience.

After purchasing and downloading your License exclusive version, the first step is to deploy the system to your server. To accommodate different users’ technical backgrounds and server environments, this article will detail 2 installation methods: Baota Panel Installation and phpStudy Panel Installation.

💡 Preparation Before Installation

Before starting, please ensure your server environment meets the following basic requirements:

• PHP Version: 8.2 or above
• Database: MySQL 5.7 or 8.0
• Extensions Required: BCMath, Ctype, cURL, DOM, Intl, Fileinfo, JSON, Mbstring, OpenSSL, PCRE, PDO, Tokenizer, XML, ZIP, GD
• Web Server: Nginx (recommended) or Apache

I. Baota Panel Installation (Recommended: Most Suitable for Chinese Users)

Baota panel is currently the most recommended production environment tool for deploying BeikeShop. The following operations are based on Baota Panel 8.0.4 and CentOS 8.5 environment.

1. Environment Installation and PHP Configuration

Before installing BeikeShop, please ensure your Baota panel has installed the following core environments:

• PHP 8.2: BeikeShop 2.0 requires PHP 8.2 or above. Please find PHP-8.2 in “Software Store” -> “Runtime Environment” and click to install.
• MySQL 5.7+: Minimum requirement is 5.7, recommended to use 5.7 or 8.0.
• Web Server: Nginx 1.10+ or Apache 2.4+ (Nginx recommended).

Critical Step: Install fileinfo Extension
BeikeShop requires the fileinfo extension to handle file uploads and validation.

1. Click the settings for PHP-8.2 in the “Installed” software list.
2. Select “Install Extension” in the popup window.
3. Search and find fileinfo, click to install and confirm.

2. Create Site and Database

1. Click “Website” -> “Add Site” on the left side.
2. Enter your domain name (ensure DNS is properly configured), and select “MySQL” in the database options.
3. Note: PHP version must be PHP-8.2.
4. Save the database name, username, and password for later use in the installation wizard.

3. Upload Source Code and Runtime Settings

1. Enter the site root directory, upload the downloaded BeikeShop v2.0 source code package and extract it.

1. Set Runtime Directory (Critical):
   • Click site settings -> “Website Directory”.
   • Change the “Runtime Directory” to /public.
     • ⚠️ Note! Please follow this order:
     • First select “Website Directory” and click save
     • Then select “Runtime Directory” and click save

1. ⚠️ Uncheck “Anti-cross-site attack (open_basedir)” option.

1. ⚠️ Configure Rewrite Rules (Nginx only):
   Find “Rewrite Rules” in site settings and fill in the following code:

   location / {
       try_files $uri $uri/ /index.php?$query_string;
   }
   

4. Execute Installation

Access your domain name in a browser, fill in the database information and administrator account according to the installation wizard, and the installation will be complete.

Welcome to visit BeikeShop Official Documentation Center for detailed installation steps (docs.beikeshop.com)

II. phpStudy Panel Installation (Suitable for Local Development and Testing)

If you are doing local debugging in a Windows or Linux environment, phpStudy panel is a very lightweight choice.

1. Environment Preparation and Source Code Placement

• Start Environment: Ensure that Nginx/Apache, MySQL, and PHP 8.2 services in phpStudy panel are running normally.

• Place Source Code: Extract the downloaded BeikeShop v2.0 source code package and place the extracted folder into the WWW directory specified by phpStudy (e.g., D:\phpstudy_pro\WWW\beikeshop).

2. Create Site and Path Settings

1. Click “Website” -> “Create Website” in the phpStudy left menu.
2. Domain Name: Enter the domain name you want to access (e.g., local.beikeshop.com).
3. Root Directory: This is the most critical step! Click browse, select the source code folder, and be sure to point the directory to the下级 /public folder. For example: D:\phpstudy_pro\WWW\beikeshop\public.
4. PHP Version: Select PHP 8.2.n from the dropdown menu.

3. Install Required PHP Extensions

BeikeShop requires specific extensions to run, especially fileinfo.

1. In phpStudy, click “Website” -> Find the domain name you want to access -> Click “Settings” -> PHP Extensions.
2. In the “PHP Extensions” list, check and install the extensions needed.

⚠️4. Configure Rewrite Rules (Nginx Environment)

If you are using Nginx, you must configure rewrite rules, otherwise pages other than the homepage will not be accessible.

1. Click “Manage” -> “Modify” -> “Rewrite Rules” in website management.
2. Enter the following code and save:

   location / {
       try_files $uri $uri/ /index.php?$query_string;
   }

5. Create Database and Execute Installation

1. Create a new database in the “Database” menu, and remember the database name, username, and password.
2. Access your configured domain name in a browser, the system will automatically jump to the installation wizard. Follow the prompts to fill in the database information, and deployment will be completed with one click.

🏆 Post-Installation Recommendations

Regardless of which installation method you choose, after entering the BeikeShop admin panel, be sure to perform the following operations:

• Change Admin Login URL: For security reasons, it is recommended to change the default admin path in the configuration file or admin settings.
• Configure SSL Certificate: Cross-border e-commerce involves payment information, it is recommended to enable HTTPS forced access.

If you encounter any problems during installation, please visit BeikeShop Official Documentation Center (docs.beikeshop.com)

Welcome to contact us!
Phone: 181-2337-4467
QQ: 9358972
QQ Group: 1033903216

Click the link to learn about the product: https://beikeshop.com/

All rights reserved. Reprint must indicate the source!