[TOC]
环境依赖
文档里明确写了不支持 Windows ，但还是可以在 Windows 里安装的，实在不行就用 docker-desktop 或 wsl2 https://experienceleague.adobe.com/en/docs/commerce-operations/installation-guide/system-requirements
- windows10 20H2
- git for windows 2.33
- php 8.1 64 位 ts 版
- composer 2.2
- mysql 8.0
- nginx 1.12
- apache 2.4
- redis 7.0
- elasticsearch 7.9
- magento 2.4.6
需要注意的事项
- magento2 的每个小版本的系统依赖都有一点不一样
- 环境的搭建可以参考这篇文章 《在Windows下配置PHP服务器》
- 环境的搭建是指 php composer mysql nginx apache redis elasticsearch 这些软件的安装和配置
- composer 和 magento 的命令最好在有管理员权限的 git bash 下运行
- php 需要开启这些拓展
bcmath ctype curl dom fileinfo filter gd hash iconv intl json libxml mbstring openssl pcre pdo_mysql simplexml soap sockets sodium tokenizer xmlwriter xsl zip zlib - php 需要修改配置文件
post_max_size = 128M memory_limit = 2048M upload_max_filesize = 64M short_open_tag = On max_execution_time = 900 max_input_time = 300 max_input_vars = 500 realpath_cache_size=10M realpath_cache_ttl=7200 - php 最好启用 opcache ，因为 magento2 真的很慢
- 调整这两个值能有效地提升性能
PHP_FCGI_CHILDREN PHP_FCGI_MAX_REQUESTS 大概就是在环境变量里设置 set PHP_FCGI_MAX_REQUESTS=1000 set PHP_FCGI_CHILDREN=32 - mysql 需要提前新建对应的数据库，并且默认编码是 utf-8
- magento2 里有大量的静态文件需要加载，启用 http2 能稍微提升一下速度
- nginx 的配置 worker_processes 要设为 cpu 逻辑核心数的两倍，例如 cpu 是 2 核 4 线程，那么 worker_processes 就是 8
- nginx php-cgi mysql 最好以管理员运行，这样可以有效避免权限的问题
- nginx php mysql 等软件和 magento2 的源码，最好不要放在系统盘，这样可以有效避免权限的问题
- 软件和源码最好都放在固态硬盘里，这样能有效地提升速度
- 其实大部分经验在 linux 环境下也适用
安装 Magento2.4
- 下载源码
- 通过 composer
- 申请一个 magento 的账号
- 生成一个用于 composer 的 access kye
- 在安装的目录里运行这句命令，要留意命令最后的
.，命令最后的参数是安装目录，.是安装到当前目录composer create-project --repository=https://repo.magento.com/ magento/project-community-edition=2.4.6 . - 安装的过程中会要求输入 magento 的 access kye
- 用 composer 下载 magento 时， puliic key 就是 username ， private key 就是 password
- 通过 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
- clone 的命令
- 通过 composer
- 安装 composer 依赖
- 准备一个 github-oauth
- 也可以参考这篇文章 《在Windows下配置PHP服务器》
- 运行安装命令
composer install - 安装的过程有点慢，要耐心地等待
- 准备一个 github-oauth
- 修改源码
- 参考下文的这一章节
使用 patch 修改源码
- 参考下文的这一章节
- 修改 hosts 文件，把域名 localhost-magento.com 指向本地 ip （其实这步没有也没关系，但为了方便下文的描述还是加上了这步）
- 正确地启动 mysql redis elasticsearch
- 在数据库里新建对应的库
create database magento2ce; - 运行安装命令
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 - 运行一些必要的命令
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 - 修改 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; } - 重启 nginx 然后在浏览器里输入 localhost-magento.com ，如无意外能看到 magento 的 home page
- 安装示例数据，这一步不是必须的
- 查看当前模式
php bin/magento deploy:mode:show - 调整到开发者模式，安装时的默认模式是 default
php bin/magento deploy:mode:set developer - 下载示例数据。
- 通过命令行下载，这一步也是需要 magento 的账号密码，如果失败，就多试几次
php bin/magento sampledata:deploy - 通过 github 下载
- clone magento2-sample-data 仓库
git clone https://github.com/magento/magento2-sample-data - 运行安装命令，这命令里的路径必须使用绝对路径，且必须在管理员权限下运行
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
- clone magento2-sample-data 仓库
- 通过命令行下载，这一步也是需要 magento 的账号密码，如果失败，就多试几次
- 更新
php bin/magento setup:static-content:deploy -f php bin/magento setup:upgrade
- 查看当前模式
- 验证
- 访问前台地址
http://localhost-magento.com - 访问后台地址
http://localhost-magento.com/admin - 进入后台之前需要禁用两步验证的模块和刷新缓存，不然会因为没有两步验证而无法进入后台, Magento_TwoFactorAuth 这个模块好像社区版没有
php bin/magento module:disable Magento_TwoFactorAuth php bin/magento cache:flush
- 访问前台地址
需要注意的事项
如果没有对应的语言包就不要修改语言设置，因为没有对应的语言包但又修改了语言设置，可能会导致一些 css 加载失败
日志在这个位置
var/log，安装过程中遇到什么问题可以在这里找日志看可以在这个文件
app/etc/env.php里查看 admin 的 url ，运行完安装命令后也会输出 admin 的 url'backend' => [ 'frontName' => 'admin_1a3uev' ],支付的设置在这里
admin >> STORE >> Configuration >> SALES >> Payment Methodsmagento2 的运行效率真的很低
可以在 magento 的根目录里运行这样的命令启动 php 的内置 web server ，但速度真的很慢，要注意修改 base-url ，可以通过修改 DEBUG_ROUTER 这个常量启用 router.php 的 debug 模式
php -S 127.0.0.1:8082 -t ./pub/ ./phpserver/router.php 在 linux 环境下，可以设置这个环境变量 PHP_CLI_SERVER_WORKERS 来达到多线程的效果 PHP_CLI_SERVER_WORKERS="10" php -S 127.0.0.1:8082 -t ./pub/ ./phpserver/router.php2.4.7 之后的版本也有一个内置的 server
php bin/magento server:run php bin/magento server:run --port=8080 php bin/magento server:run --port=8080 --workerNum=10magento2 的缓存十分严重，如果发现一些修改没有生效，可以尝试运行这几条命令刷新缓存
php bin/magento cache:clean php bin/magento indexer:reindex php bin/magento cache:flush如果运行了上面几句命令都没有效果，可以试试直接删掉对应的临时文件，像这样
rm -rf var/di/* var/generation/* var/cache/* var/page_cache/* var/view_preprocessed/* var/composer_home/cache/* rm -rf generated/code/* generated/metadata/* rm -rf pub/static/*可以修改 app/etc/env.php 使用 redis 作为缓存，这是 redis 大致的配置，使用 redis 后能有效地提升速度
'session' => [ 'save' => 'redis', 'redis' => [ 'host' => '127.0.0.1', 'port' => '6379', 'password' => '', 'timeout' => '2.5', 'persistent_identifier' => '', 'database' => '2', 'compression_threshold' => '2048', 'compression_library' => 'gzip', 'log_level' => '4', 'max_concurrency' => '6', 'break_after_frontend' => '5', 'break_after_adminhtml' => '30', 'first_lifetime' => '600', 'bot_first_lifetime' => '60', 'bot_lifetime' => '7200', 'disable_locking' => '0', 'min_lifetime' => '60', 'max_lifetime' => '2592000' ] ], 'cache' => [ 'frontend' => [ 'default' => [ 'backend' => 'Cm_Cache_Backend_Redis', 'backend_options' => [ 'server' => '127.0.0.1', 'database' => '0', 'port' => '6379' ], ] ] ],为了开发方便，可以关掉 merge_files 和 minify_files ， css 和 js 的都关掉，但加载一大堆小文件也会拖慢速度，在 app/etc/config.php 里配置
'system' => [ 'default' => [ 'dev' => [ 'js' => [ 'merge_files' => '0', 'minify_files' => '0', 'enable_js_bundling' => '0' ], 'css' => [ 'minify_files' => '0', 'merge_css_files' => '0' ], ] ] ],在 php 的配置文件启用命令行的 opcache
opcache.enable_cli=1启用 jit 也能提升速度，但启用 jit 需要禁用 xdebug ，启用 jit 需要启用 opcache
opcache.jit=1255 opcache.jit_buffer_size=128M使用开发者模式可以不用编译，但运行速度会变得更慢
关掉 xdebug 后速度也有提升
运行这句 composer 命令
composer dumpautoload -o后速度也有提升- 这句需要运行在
php bin/magento setup:di:compile后面 - 这句需要运行在
php bin/magento setup:static-content:deploy -f前面 - 如果是开发者模式就不要运行这句
- 这句需要运行在
运行部署静态文件这条命令时最好翻墙，不然一些字体文件没法下载
php bin/magento setup:static-content:deploy打开浏览器的开发者工具时，关掉禁用缓存的选项也能提升速度， magento2 的静态文件真的非常多，但有时又会因为浏览器的缓存这样观察不到更新
使用 imdisk 这类内存硬盘能有效地提升速度。但内存硬盘存在断电后数据丢失的风险，而且真的非常消耗内存，内存至少也要有 16G
- 只把生成的目录和文件放在内存硬盘里，这里需要用软连接把 var 和 generated 文件夹映射到内存硬盘
- 把整套项目源码放在内存硬盘里
- 把整套项目源码和数据库都放在内存硬盘里
可以使用 Papercut-SMTP mailpit 这类软件来接收测试的邮件
浏览器禁用图片的加载也能有效地提升速度
magento2 有三种模式，按性能由低到高，依次为：developer < default < production ；除此之外还有一个维护模式 maintenance ，用户访问会返回 503
通过 composer 安装的 magento 的框架文件在这个目录里
vendor/magento/framework通过 github 源码安装的 magento 的框架文件在这个目录里
lib/internal/Magento/Frameworkgithub 代码里的 app/magento/ 下那一堆 模块 对应 通过 composer 安装的 vendor/magento/module-* 的模块
如果没有开启url重写，大部分链接前面都会带着 index.php，如果开了url重写则没有 index.php
- 例如 后台的链接
没有url重写 /index.php/admin 有url重写 /admin
- 例如 后台的链接
magento2 的官网推荐使用 nginx 做 es 的反向代理，这样就可以给 es 加上 http 认证
配置 vscode 的 xml 文件语法高亮
- vscode 里装上这个插件
XML Language Support by Red Hat - 在项目根目录运行这句命令
php bin/magento dev:urn-catalog:generate --ide vscode -- .vscode/misc.xml - 在 vscode 的配置文件
.vscode/settings.json里加上这几句{ "xml.catalogs": [ ".vscode\\misc.xml" ], "xml.validation.resolveExternalEntities": true, "xml.codeLens.enabled": true, }
- vscode 里装上这个插件
在 vscode 中关掉 git 的自动刷新
"git.autorefresh": false在 vscode 中可以用这样的配置来忽略一些文件的解析
"intelephense.references.exclude": [ "**/vendor/**", "generated", "dev", "var", "pub/media", "pub/static" ]
不使用 es
禁用 es 相关的模块，用这个库来替换
https://github.com/swissup/module-search-mysql-legacy
因为 Elasticsearch 的存在使得门槛高了不少。笔者感觉奥多比正在抛弃中小用户。 笔者感到很奇怪，没有 redis 也可以安装，但没有 Elasticsearch 却不行。
安装时就排除 es
- 修改安装命令
- 排除 es 相关的配置
就是安装命令里删掉这几个参数 --search-engine --elasticsearch-host --elasticsearch-port --elasticsearch-index-prefix - 禁用 es 相关的模块
就是安装命令里加上这一个参数 --disable-modules=Magento_Elasticsearch,Magento_Elasticsearch7,Magento_OpenSearch 2.4 的小版本里，有好几个和 es 相关的模块 Magento_Elasticsearch Magento_Elasticsearch6 Magento_Elasticsearch7 Magento_Elasticsearch8 Magento_InventoryElasticsearch Magento_OpenSearch 2.4.5 是 Magento_Elasticsearch,Magento_Elasticsearch7,Magento_Elasticsearch6 2.4.6 是 Magento_Elasticsearch,Magento_Elasticsearch7,Magento_OpenSearch 2.4.8 是 Magento_Elasticsearch,Magento_Elasticsearch8,Magento_OpenSearch - 比较完整的安装命令，但仅供参考
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
- 排除 es 相关的配置
- 安装 mysql 搜索模块
composer require swissup/module-search-mysql-legacy --prefer-source --ignore-platform-reqs - 启用 mysql 搜索模块
php bin/magento module:enable Swissup_SearchMysqlLegacy Swissup_Core php bin/magento setup:upgrade --safe-mode=1 php bin/magento setup:di:compile - 把搜索的引擎设为 mysql
- 用命令行设置
php bin/magento config:set catalog/search/engine 'lmysql' - 在后台设置
AdminPortal > Store > Settings > Configuration > CATALOG > Catalog > Catalog Search > Search Engine
- 用命令行设置
- 刷新索引
php bin/magento indexer:reindex
安装完后再排除 es
- 进入维护模式
php bin/magento maintenance:enable - 禁用 es 相关的模块
php bin/magento module:disable Magento_Elasticsearch Magento_Elasticsearch7 Magento_OpenSearch 2.4 的小版本里，有好几个和 es 相关的模块 最好先用 php bin/magento module:status 看看有哪些和 es 相关的模块再禁用 - 安装 mysql 搜索模块
- 和上一节一样
- 启用 mysql 搜索模块
- 和上一节一样
- 把搜索的引擎设为 mysql
- 和上一节一样
- 刷新索引
- 和上一节一样
- 退出维护模式
php bin/magento maintenance:disable
使用 patch 修改源码
- 要注意区分通过 composer 安装和通过 github 安装的路径
- 这个 patch 要在项目的根目录下运行，
- 这个 patch 要在 composer install 之后运行， php bin/magento setup:upgrade 前运行
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,
--- lib/internal/Magento/Framework/Interception/PluginList/PluginList.php 2026-05-21 11:54:31.838225000 +0800
+++ lib/internal/Magento/Framework/Interception/PluginList/PluginList.php 2026-05-21 17:14:00.172654000 +0800
@@ -217,7 +217,7 @@ class PluginList extends Scoped implemen
}
$this->_scopePriorityScheme[] = $scope;
- $cacheId = implode('|', $this->_scopePriorityScheme) . "|" . $this->_cacheId;
+ $cacheId = implode('-', $this->_scopePriorityScheme) . "-" . $this->_cacheId;
$configData = $this->configLoader->load($cacheId);
if ($configData) {
这是针对使用 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',
'lib/internal/Magento/Framework/Interception/PluginList/PluginList.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);
$rmArr = array_map(function($item) {
return sprintf("rm %s ", str_replace('.php', '2.php', $item));
}, $targetArr);
array_map(function($item) {
echo join(';' . PHP_EOL, $item) . PHP_EOL . PHP_EOL;
return $item;
}, [$cpArr, $diffArr, $sedArr, $rmArr]);
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 相关的博客