f2h2h1.github.io

在 Windows 下安装 Magento2

[TOC]

环境依赖

需要注意的事项

安装 Magento2.3

  1. 申请一个 magento 的账号
  2. 生成一个用于 composer 的 access kye
  3. 在安装的目录里运行这句命令，要留意命令最后的 . ，命令最后的参数是安装目录， . 是安装到当前目录 
     composer create-project --repository=https://repo.magento.com/ magento/project-community-edition=2.3.7 .
  4. 安装的过程中会要求输入 magento 的 access kye
    • 用 composer 下载 magento 时， puliic key 就是 username ， private key 就是 password
  5. 安装的过程有点慢，要耐心地等待
  6. magento2 的依赖有点多，最好准备一个 github-oauth
  7. 修改源码
    1. vendor\magento\framework\Image\Adapter\Gd2.php 大概在 90 行左右的位置 
       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;
 }
    2. vendor\magento\framework\View\Element\Template\File\Validator.php 大概在 140 行左右的位置 
       protected function isPathInDirectories($path, $directories)
 {
     if (!is_array($directories)) {
         $directories = (array)$directories;
     }
     //$realPath = $this->fileDriver->getRealPath($path);
     $realPath = str_replace('\\', '/', $this->fileDriver->getRealPath($path));
     foreach ($directories as $directory) {
         if (0 === strpos($realPath, $directory)) {
             return true;
         }
     }
     return false;
 }
  8. 修改 hosts 文件，把域名 localhost-magento 指向本地 ip （其实这步没有也没关系，但为了方便下文的描述还是加上了这步）
  9. 运行安装命令 
     php bin/magento setup:install `
     --base-url=http://localhost-magento/ `
     --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
  10. 运行一些必要的命令 
     php bin/magento setup:upgrade
 php bin/magento setup:di:compile
 php bin/magento indexer:reindex
 php bin/magento setup:static-content:deploy -f
 php bin/magento cache:flush
  11. 修改 nginx 的配置 
     upstream fastcgi_backend {
     server  127.0.0.1:9001;
 }
 server {
     listen 80;

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

     server_name  localhost-magento;
     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;
 }
  12. 重启 nginx 然后在浏览器里输入 localhost-magento ，如无意外能看到 magento 的 home page
  13. 安装示例数据，这一步不是必须的
    1. 调整到开发者模式，安装时的默认模式是 default 
       php bin/magento deploy:mode:set developer
    2. 下载示例数据。这一步也是需要 magento 的账号密码，如果失败，就多试几次 
       php bin/magento sampledata:deploy
    3. 更新 
       php bin/magento setup:upgrade

需要注意的事项

除了可以通过 compoer 安装外，还可以通过 github 的仓库安装。

安装 2.4

笔者发现 magento2 的每个小版本的系统依赖都有一点不一样 https://devdocs.magento.com/guides/v2.4/install-gde/system-requirements.html

2.3 和 2.4 的主要区别是

因为 Elasticsearch 的存在使得门槛高了不少。笔者感觉奥多比正在抛弃中小用户。

安装流程和注意事项和 2.3 的基本一致。

安装 Elasticsearch

2.4.0 依赖的 elasticsearch 版本为 7.6 。

直接从官网下载就可以了，下载后解压，然后运行 bin/elasticsearch.bat 。压缩包里原本就带着 jdk 。

magento2 的官网推荐使用 nginx 做 es 的反向代理，这样就可以给 es 加上 http 认证。

安装步骤和 2.3 的区别

  1. 下载 magento2 的命令要把版本号改为 2.4.0 
     composer create-project --repository=https://repo.magento.com/ magento/project-community-edition=2.4.0 .
  2. 修改源码
    1. vendor\magento\framework\App\StaticResource.php 大概在 278 行左右的位置 
       private function isThemeAllowed(string $theme): bool
 {
 $theme = str_replace('\\', '/', $theme); //fix windows path
 return in_array($theme, array_keys($this->themePackageList->getThemes()));
 }
  3. 安装命令要加上 Elasticsearch 的配置 
     php bin/magento setup:install `
     --base-url=http://localhost-magento/ `
     --db-host=localhost `
     --db-name=magento2ce2 `
     --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
  4. 进入后台之前需要禁用两步验证的模块和刷新缓存，不然会因为没有两步验证而无法进入后台 
     php bin/magento module:disable Magento_TwoFactorAuth
 php bin/magento cache:flush

参考

用户指南 https://docs.magento.com/user-guide/

开发文档 https://devdocs.magento.com/

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

magento 相关的博客

This site is open source. Improve this page.