Magento là 1 framework mã nguồn mở dùng để thiết kế website bán hàng phổ biến...

Bài này sẽ hướng dẫn các bạn cách cài đặt 1 dự án magento trên xampp. Bắt đầu thôi nào!

1.Đầu tiên, download và cài đặt xampp trên window

Vào trang chủ của XAMPP download và cài đặt như bình thường.

2.Cài đặt Elasticsearch

Download Elasticsearch tại đây .

Giải nén vào thư mục htdocs của XAMPP

Vào thư mục elasticsearch-7.6.2 / bin và chạy elasticsearch.bat bằng quyền của quản trị viên

Có thể kiếm tra tại cổng localhost:9200

Lưu ý: Không tắt cửa sổ này khi đang cài đặt magento

3.Hiệu lực các extension trước khi cài đặt

Mở file php.ini theo đường dẫn C:\xampp\php. Enable các extension sau bằng cách remove dấu ; và lưu lại

;extension=gd 
;extension=intl 
;extension=soap 
;extension=xsl 
;extension=sockets 
;extension=sodium

Thay đổi thêm các dòng

max_execution_time=3000 
max_input_time=2000 
memory_limit=3G

Sau đó khởi động lại Apache và Mysql

4.Tải Magento

Có 2 cách tải là dùng dòng lệnh và tải thủ công. Ở đây mình sẽ truy cập vào trang github của magento để chọn phiên bản và tải

Giải nén file vào thư mục htdocs của XAMPP

5.Sửa một số lỗi trước khi cài đặt

Tại file xampp\htdocs\folder_magento\lib\internal\Magento\Framework\Image\Adapter\Gd2.php sửa validateURLScheme thành

private function validateURLScheme(string $filename) : bool
    {
        if(!file_exists($filename)) { // if file not exist
            $allowed_schemes = ['ftp', 'ftps', 'http', 'https'];
            $url = parse_url($filename);
            if ($url && isset($url['scheme']) && !in_array($url['scheme'], $allowed_schemes)) {
                return false;
            }
        }
        return true;
    }

Tại file xampp\htdocs\folder_magento\lib\internal\Magento\Framework\View\Element\Template\File\Validator.php

strpos($realPath, $directory)

thành

strpos($path, $directory)

File app/etc/di.xml

Magento\Framework\App\View\Asset\MaterializationStrategy\Symlink

thành

Magento\Framework\App\View\Asset\MaterializationStrategy\Copy

6.Tạo virtual host (nên tạo)

Kể từ phiên bản 2.4.2 thì magento đã di chuyển Document Root vào thư mục pub. Nghĩa là phải truy cập localhost/folder_magento/pub để vào trang chủ và localhost/folder_magento/pub/admin để vào phần admin

Tuy nhiên việc này sẽ bất tiện khi mỗi trang phải thêm /pub và sẽ phát sinh lỗi không mong muốn. Vì vậy ta sẽ sử dụng virtual host như một địa chỉ ảo vừa để đẹp url cũng như fix các lỗi đó

Mở file C:\xampp\apache\conf\extra\httpd-vhosts.conf và thêm đoạn sau

<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs/magento2/pub"
    ServerName bqsoft.localhost
</VirtualHost>

Chỉnh ServerName theo mong muốn của bạn

7.Tạo database

Truy cập localhost/phpmyadmin , tạo 1 database tên là magento

8.Cài đặt magento

Vào folder magento, chạy lệnh sau

php bin/magento setup:install --base-url="http://bqsoft.localhost" --db-host="localhost" --db-name="magento" --db-user="root" --admin-firstname="admin" --admin-lastname="admin" --admin-email="bqsoftvn@gmail.com" --admin-user="admin" --admin-password="admin123" --language="en_US" --currency="USD" --timezone="America/Chicago" --use-rewrites="1" --backend-frontname="admin" --search-engine=elasticsearch7 --elasticsearch-host="localhost" --elasticsearch-port=9200

Trong đó:

• --db-name là database vừa tạo ở trên
• --base-url là ServerName của bạn ở trên
• Mỗi khi thay đổi ServerName thì phải chạy lệnh cài đặt trên lại nhé!

Sau khi hoàn tất chạy tiếp các lệnh sau

php bin/magento indexer:reindex
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush

9.Cuối cùng, xử lý lỗi 404 (cho version 2.4.2 trở lên)

Tại file .htaccess của folder gốc, thay nội dung thành

RewriteEngine on
RewriteCond %{REQUEST_URI} !^pub/
RewriteCond %{REQUEST_URI} !^/setup/
RewriteCond %{REQUEST_URI} !^/update/
RewriteCond %{REQUEST_URI} !^/dev/
RewriteRule .* pub/$0 [L]
DirectoryIndex index.php

Gõ ServerName hoặc ServerName/admin để vào trang quản trị

Kết quả khi hoàn thành!

Trong quá trình cài đặt nếu có thêm lỗi nào thì các bạn vào file C:\xampp\htdocs\folder_magento\var\log\debug.log để kiểm tra lỗi và fix nhé!