Home

在 Windows 下安装 Magento2

这篇文章最后更新的时间在六个月之前，文章所叙述的内容可能已经失效，请谨慎参考！

[TOC]

环境依赖

文档里明确写了不支持 Windows ，但还是可以在 Windows 里安装的，实在不行就用 docker-desktop 或 wsl2 https://experienceleague.adobe.com/en/docs/commerce-operations/installation-guide/system-requirements

需要注意的事项

安装 Magento2.4

  1. 下载源码
    1. 通过 composer
      1. 申请一个 magento 的账号
      2. 生成一个用于 composer 的 access kye
      3. 在安装的目录里运行这句命令，要留意命令最后的 . ，命令最后的参数是安装目录， . 是安装到当前目录
        composer create-project --repository=https://repo.magento.com/ magento/project-community-edition=2.4.6 .
      4. 安装的过程中会要求输入 magento 的 access kye
        • 用 composer 下载 magento 时， puliic key 就是 username ， private key 就是 password
    2. 通过 github
      • clone 的命令
        clone 整个仓库后再切换分支
git clone https://github.com/magento/magento2.git .
git pull
git switch 2.4.6-p1
只 clone 一个分支
git clone -b 2.4.6-p1 https://github.com/magento/magento2.git --depth=1 .

切换到对应的 tag
git pull
git checkout 2.4.5
      • 只 clone 一个分支，以更快的方式
        git clone -b 2.4.6-p7 --single-branch --no-tags https://github.com/magento/magento2.git --depth=1 .
      • 如果 clone 速度太慢，可以在 releases 那里下载源码的压缩包（如果还是太慢就用一些下载工具来下载 releases 的压缩包）
        curl -L -o magento2.tar.gz --connect-timeout 120 --max-time 3600 --retry 100 --retry-delay 5 https://github.com/magento/magento2/archive/refs/tags/2.4.6-p8.tar.gz
  2. 安装 composer 依赖
    1. 准备一个 github-oauth
      • 也可以参考这篇文章 《在Windows下配置PHP服务器》
    2. 运行安装命令 composer install
    3. 安装的过程有点慢，要耐心地等待
  3. 修改源码
    • 参考下文的这一章节 使用 patch 修改源码
  4. 修改 hosts 文件，把域名 localhost-magento.com 指向本地 ip （其实这步没有也没关系，但为了方便下文的描述还是加上了这步）
  5. 正确地启动 mysql redis elasticsearch
  6. 在数据库里新建对应的库
    create database magento2ce;
  7. 运行安装命令
    php bin/magento setup:install  \
    --base-url=http://localhost-magento.com/  \
    --db-host=localhost  \
    --db-name=magento2ce \
    --db-user=root  \
    --db-password=1234  \
    --admin-firstname=admin  \
    --admin-lastname=admin  \
    --admin-email=admin@admin.com  \
    --admin-user=admin  \
    --admin-password=admin123  \
    --language=en_US  \
    --currency=USD  \
    --timezone=America/Chicago  \
    --use-rewrites=1  \
    --search-engine=elasticsearch7  \
    --elasticsearch-host=localhost  \
    --elasticsearch-port=9200  \
    --elasticsearch-index-prefix=magento2
  8. 运行一些必要的命令
    php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento indexer:reindex
php bin/magento cache:flush
  9. 修改 nginx 的配置
    upstream fastcgi_backend {
    server  127.0.0.1:9001;
}
server {
    listen 80;

    # listen 443 ssl http2;
    # ssl_certificate  ./cert/localhost-magento.com/domain.crt;
    # ssl_certificate_key ./cert/localhost-magento.com/rsa_private_key.pem;

    access_log  logs/localhost-magento.access.log;
    error_log  logs/localhost-magento.error.log;

    server_name  localhost-magento.com;
    set $MAGE_ROOT C:/code/magento-community; # 这里是 magento 的根目录
    set $MAGE_DEBUG_SHOW_ARGS 1;
    include C:/code/magento-community/nginx.conf.sample; # 这里是 magento 的根目录里的 nginx.conf.sample
    fastcgi_buffers 16 16k;
    fastcgi_buffer_size 32k;
    proxy_buffer_size 128k;
    proxy_buffers 4 256k;
    proxy_busy_buffers_size 256k;
}
  10. 重启 nginx 然后在浏览器里输入 localhost-magento.com ，如无意外能看到 magento 的 home page
  11. 安装示例数据，这一步不是必须的
    1. 查看当前模式
      php bin/magento deploy:mode:show
    2. 调整到开发者模式，安装时的默认模式是 default
      php bin/magento deploy:mode:set developer
    3. 下载示例数据。
      1. 通过命令行下载，这一步也是需要 magento 的账号密码，如果失败，就多试几次
        php bin/magento sampledata:deploy
      2. 通过 github 下载
        1. clone magento2-sample-data 仓库
          git clone https://github.com/magento/magento2-sample-data
        2. 运行安装命令，这命令里的路径必须使用绝对路径，且必须在管理员权限下运行
          php -f /d/magento2-sample-data/dev/tools/build-sample-data.php -- --sample-data-source="/d/magento2-sample-data" --ce-source="/d/magento-ce" --command=link
    4. 更新
      php bin/magento setup:static-content:deploy -f
php bin/magento setup:upgrade
  12. 验证
    • 访问前台地址 http://localhost-magento.com
    • 访问后台地址 http://localhost-magento.com/admin
    • 进入后台之前需要禁用两步验证的模块和刷新缓存，不然会因为没有两步验证而无法进入后台, Magento_TwoFactorAuth 这个模块好像社区版没有
      php bin/magento module:disable Magento_TwoFactorAuth
php bin/magento cache:flush

需要注意的事项

不使用 es

禁用 es 相关的模块，用这个库来替换

https://github.com/swissup/module-search-mysql-legacy

因为 Elasticsearch 的存在使得门槛高了不少。笔者感觉奥多比正在抛弃中小用户。 笔者感到很奇怪，没有 redis 也可以安装，但没有 Elasticsearch 却不行。

安装时就排除 es

  1. 修改安装命令
    1. 排除 es 相关的配置
      就是安装命令里删掉这几个参数
--search-engine
--elasticsearch-host
--elasticsearch-port
--elasticsearch-index-prefix
    2. 禁用 es 相关的模块
      就是安装命令里加上这一个参数
--disable-modules=Magento_Elasticsearch,Magento_Elasticsearch7,Magento_OpenSearch
2.4 的小版本里，有好几个和 es 相关的模块
Magento_Elasticsearch
Magento_Elasticsearch6
Magento_Elasticsearch7
Magento_InventoryElasticsearch
Magento_OpenSearch
2.4.5 是 Magento_Elasticsearch,Magento_Elasticsearch7,Magento_Elasticsearch6
2.4.6 是 Magento_Elasticsearch,Magento_Elasticsearch7,Magento_OpenSearch
    3. 比较完整的安装命令，但仅供参考
      php bin/magento setup:install  \
    --base-url=http://localhost-magento.com/  \
    --db-host=localhost  \
    --db-name=magento2ce  \
    --db-user=root  \
    --db-password=1234  \
    --admin-firstname=admin  \
    --admin-lastname=admin  \
    --admin-email=admin@admin.com  \
    --admin-user=admin  \
    --admin-password=admin123  \
    --language=en_US  \
    --currency=USD  \
    --timezone=Asia/Shanghai  \
    --use-rewrites=0 \
    --disable-modules=Magento_Elasticsearch,Magento_Elasticsearch7,Magento_OpenSearch
  2. 安装 mysql 搜索模块
    composer require swissup/module-search-mysql-legacy --prefer-source --ignore-platform-reqs
  3. 启用 mysql 搜索模块
    php bin/magento module:enable Swissup_SearchMysqlLegacy Swissup_Core
php bin/magento setup:upgrade --safe-mode=1
php bin/magento setup:di:compile
  4. 把搜索的引擎设为 mysql
    • 用命令行设置
      php bin/magento config:set catalog/search/engine 'lmysql'
    • 在后台设置
      AdminPortal > Store > Settings > Configuration > CATALOG > Catalog > Catalog Search > Search Engine
  5. 刷新索引
    php bin/magento indexer:reindex

安装完后再排除 es

  1. 进入维护模式
    php bin/magento maintenance:enable
  2. 禁用 es 相关的模块
    php bin/magento module:disable Magento_Elasticsearch Magento_Elasticsearch7 Magento_OpenSearch
2.4 的小版本里，有好几个和 es 相关的模块
最好先用 php bin/magento module:status 看看有哪些和 es 相关的模块再禁用
  3. 安装 mysql 搜索模块
    • 和上一节一样
  4. 启用 mysql 搜索模块
    • 和上一节一样
  5. 把搜索的引擎设为 mysql
    • 和上一节一样
  6. 刷新索引
    • 和上一节一样
  7. 退出维护模式
    php bin/magento maintenance:disable

使用 patch 修改源码

patch 文件的内容

--- lib/internal/Magento/Framework/Image/Adapter/Gd2.php	2023-12-19 17:16:58.149464800 +0800
+++ lib/internal/Magento/Framework/Image/Adapter/Gd2.php	2023-12-19 17:22:09.469880100 +0800
@@ -91,10 +91,12 @@ class Gd2 extends AbstractAdapter
      */
     private function validateURLScheme(string $filename) : bool
     {
-        $allowed_schemes = ['ftp', 'ftps', 'http', 'https'];
-        $url = parse_url($filename);
-        if ($url && isset($url['scheme']) && !in_array($url['scheme'], $allowed_schemes)) {
-            return false;
+        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;
--- lib/internal/Magento/Framework/View/Element/Template/File/Validator.php	2023-12-19 17:17:02.495932300 +0800
+++ lib/internal/Magento/Framework/View/Element/Template/File/Validator.php	2023-12-19 17:23:23.889091300 +0800
@@ -135,7 +135,8 @@ class Validator
         if (!is_array($directories)) {
             $directories = (array)$directories;
         }
-        $realPath = $this->fileDriver->getRealPath($path);
+        // $realPath = $this->fileDriver->getRealPath($path);
+        $realPath = str_replace('\\', '/', $this->fileDriver->getRealPath($path));
         foreach ($directories as $directory) {
             if ($directory !== null && 0 === strpos($realPath, $directory)) {
                 return true;
--- lib/internal/Magento/Framework/App/StaticResource.php	2023-12-19 17:16:54.560803000 +0800
+++ lib/internal/Magento/Framework/App/StaticResource.php	2023-12-19 17:21:47.440984600 +0800
@@ -285,6 +285,7 @@ class StaticResource implements \Magento
      */
     private function isThemeAllowed(string $theme): bool
     {
+        $theme = str_replace('\\', '/', $theme); // fix windows path
         return in_array($theme, array_keys($this->themePackageList->getThemes()));
     }
 }
--- lib/internal/Magento/Framework/Interception/PluginListGenerator.php	2023-12-19 17:16:58.383831000 +0800
+++ lib/internal/Magento/Framework/Interception/PluginListGenerator.php	2023-12-19 17:22:39.196325500 +0800
@@ -153,7 +153,8 @@ class PluginListGenerator implements Con
                 if (false === in_array($scope, $this->scopePriorityScheme, true)) {
                     $this->scopePriorityScheme[] = $scope;
                 }
-                $cacheId = implode('|', $this->scopePriorityScheme) . "|" . $this->cacheId;
+                // $cacheId = implode('|', $this->scopePriorityScheme) . "|" . $this->cacheId;
+                $cacheId = implode('-', $this->scopePriorityScheme) . "-" . $this->cacheId;
                 [
                     $virtualTypes,
                     $this->scopePriorityScheme,

这是针对使用 github 新建的项目，如果是通过 composer 新建的项目，要替换一些路径

sed -i 's/lib\/internal\/Magento\/Framework\//vendor\/magento\/framework\//g' windows.patch;

执行 patch 的命令，要在项目的根目录运行

patch --verbose -p0 --no-backup-if-mismatch < windows.patch;

生成 patch 文件的方式

\define('PATCH_FILE', 'windows.patch');
$targetArr = [
    'lib/internal/Magento/Framework/Image/Adapter/Gd2.php',
    'lib/internal/Magento/Framework/View/Element/Template/File/Validator.php',
    'lib/internal/Magento/Framework/App/StaticResource.php',
    'lib/internal/Magento/Framework/Interception/PluginListGenerator.php',
];

echo "
先确定好哪些文件需要修改
复制一份
修改文件
生成 patch 文件，patch 的文件结尾要有一个空行
替换 patch 文件里的路径
在项目根目录执行 patch
";

echo PHP_EOL . PHP_EOL;

$cpArr = array_map(function($item) {
    return 'cp ' . $item . ' ' . str_replace('.php', '2.php', $item);
}, $targetArr);

$diffArr = array_map(function($item) {
    return str_replace('cp ', 'diff -up ', $item) . ' >> ' . PATCH_FILE;
}, $cpArr);

$sedArr = array_map(function($item) {
    $item = str_replace('/', '\/', $item);
    $a = str_replace('.php', '2.php', $item);
    $b = $item;
    return sprintf("sed -i 's/%s/%s/g' " . PATCH_FILE, $a, $b);
}, $targetArr);

array_map(function($item) {
    echo join(';' . PHP_EOL, $item) . PHP_EOL . PHP_EOL;
    return $item;
}, [$cpArr, $diffArr, $sedArr]);

echo 'patch --verbose -p0 --no-backup-if-mismatch < ' . PATCH_FILE . PHP_EOL;

参考

安装指南 https://experienceleague.adobe.com/zh-hans/docs/commerce-operations/installation-guide/overview

开发文档 https://developer.adobe.com/commerce/php/development/

github https://github.com/magento/magento2

magento 相关的博客