Magento / Adobe Commerce 安装新主题

Magento / Adobe Commerce 安装完成之后，首页空荡荡的。需要一个主题装饰一下。

下载主题

下载主题，通常是个 zip 压缩包文件，然后 scp 上传到服务器。

解压文件

例如，解压到一个名为 theme-files 的目录

unzip <archive>.zip -d theme-files

备份

备份 magento 项目下的两个目录：

将数据库也备份。因为安装主题会更新数据库信息。

复制文件目录

进入 magento 安装的根目录，即有 app 和 pub 的目录：

cp -R <theme-files>/app/* app
cp -R <theme-files>/pub/* pub

修改权限：

chown -R :www-data .

执行命令

bin/magento setup:upgrade
bin/magento setup:static-content:deploy -f

注：

setup:upgrade 并不是字面上的看起来要升级 magento 版本的意思，而是在安装了或者升级了模块之后，需要保证数据库的表结构也同步更新。
setup:static-content:deploy 则是如字面意思，将新主题的 css，js，图片部署。-f 则是强制覆盖同名文件。

参考：

https://magento.stackexchange.com/questions/368013/how-and-when-should-i-use-the-magento-2-commands-bin-magento-setupupgrade-bin

清除缓存

即，flush store cache。登录 magento 后台，System - Cache Management，点击右上角的 Flush Magento Cache 按钮。

或者执行：

bin/magento cache:flush

重新登录后台

退出后台，并重新登录。

选择主题

Content - Design - Configuration

报错 1

Deprecated Functionality: Creation of dynamic property Hiddentechies\Next\Model\Block\Converter::$eavConfig is deprecated in magento/app/code/Hiddentechies/Next/Model/Block/Converter.php on line 58

这个看起来是用 PHP 8.0 语法写的代码，但是 magento 2.4.6 是 8.1, 8.2 以上版本，所以导致报错。

安装主题后

估计是安装主题报错，导致的 magento 内部错误。网站直接打不开了。。。后台也报错。

There has been an error processing your request

恢复 Magento 系统

docker compose stop mysql
清理 mysql 数据；并删除此容器。（好在是一个新安装的 magento 环境，而非运营中的生产环境）
重新生成一个 mysql 容器
fpm 镜像：删除这个被毁坏的 magento 项目。fpm 容器重建最好。
重新执行安装步骤

参考

https://www.nexcess.net/blog/install-theme-in-magento/
https://www.hiddentechies.com/documentation/magento2/next/#intro

后续

终于成功安装了一回：Magento 2 安装 breeze evolution 主题

关于作者 🌱

我是来自山东烟台的一名开发者，有感兴趣的话题，或者软件开发需求，欢迎加微信 zhongwei 聊聊，或者关注我的个人公众号“大象工具”，查看更多联系方式