知识库｜湖南麓川信息科技有限公司

====== Magento ======

===== Magento版本介绍 =====

Magento包含社区版（Magento Open Source）和企业版（Magento Commerce）两种版本，其中社区版免费开源。

===== Magento安装 =====

[[http://devdocs.magento.com|Magento开发者文档]]（包括安装、前后端开发等）

==== Magento环境要求 ====

详见[[http://devdocs.magento.com/guides/v2.1/install-gde/system-requirements-tech.html|Magento 2.1 环境要求官方文档]]

  * 64位Linux操作系统(RedHat Enterprise Linux(RHEL), CentOS, Ubuntu, Debian等)
  * Web服务器(Apache2, nginx）
  * PHP及PHP扩展
  * 数据库（MySQL等）

==== Magento安装步骤 ====

<HTML><ul></HTML>
<HTML><li></HTML>[[http://www.magento.com/download|下载Magento Open Source]]<HTML></li></HTML>
<HTML><li></HTML>上传到服务器(使用ftp或scp等)<HTML></li></HTML>
<HTML><li></HTML>解压安装包到合适的目录([[:tar]], gunzip, unar等)<HTML></li></HTML>
<HTML><li></HTML>安装<HTML></li></HTML>
<HTML><li></HTML>命令行安装<HTML></li></HTML>
<HTML><li></HTML><HTML><p></HTML>安装向导安装（[[http://devdocs.magento.com/guides/v2.1/install-gde/install/web/install-web.html|官方向导安装文档]]）<HTML></p></HTML>
<HTML><p></HTML>使用浏览器打开''%%http://<magento_host_or_ip>/<magento_path>/setup%%''，例如''%%http://127.0.0.1/magento2ce/setup%%''，然后按照提示安装即可<HTML></p></HTML>
<HTML><p></HTML>Magento2.1向导安装一共6步，1. Readiness Check; 2. Add a Database; 3. Web Configuration; 4. Customize Your Store; 5. Create Admin Account; 6. Install<HTML></p></HTML><HTML></li></HTML><HTML></ul></HTML>

==== Magento安装常见问题 ====

=== setup页面无法正确显示 ===

如果打开setup页面，没有显示magento的安装页面，而是纯文本内容，可能是apache没有启用php模块，参照[[apache2配置#apache2_php配置|Apache PHP配置]] {{magento_home_page_without_style.png?400|}}

=== Readiness Check失败 ===

  * PHP Settings Check：You must have installed GD library with --with-jpeg-dir=DIR option.

Ubuntu下通过''%%sudo apt install php7.0-gd%%''并''%%sudo service apache2 restart%%''安装GP支持

  * PHP Extensions Check: 11 missing PHP extensions.

Ubuntu下通过''%%sudo apt install php7.0-<module_name>%%''安装缺失的扩展（即extension）并重启apache2服务即可。

module名称基本与extension名称相同，但是部分module可能包含了多个extension，如果安装过程中发现php7.0-<html><module\_name></html>没有找到，那就先不管。其中dpo_mysql对应的module是php7.0-mysql而不是php7.0-dpo_mysql

  * File Permission Check: 5 file permission not met

将magento根目录的owner设置为www-data即可，例如''%%sudo chown www-data:www-data /var/www/html/magento2ce -R%%''

=== Add a Database失败 ===

提示：Database 'magento' does not exist or specified database server user does not have privileges to access this database.

需要在服务器上先进入mysql数据库，手动创建数据库

=== 安装成功后404错误（包括打开首页样式错误和admin页面404错误） ===

解决方案：启用Apache2的rewrite，详细操作如下（以Apache2.4配置为例）：

  * 启用rewrite模块''%%sudo a2enmod rewrite%%''
  * 修改Apache2站点配置（Ubuntu下通常是''%%/etc/apache2/sites-available/000-default.conf%%''），添加：

<code>
  <Directory "/var/www/html">
      AllowOverride  <value from Apache site>
  </Directory>
</code>
  * 重启Apache2''%%sudo service apache2 restart%%''

===== Magento配置 =====

==== Magento cron job配置(TBD) ====

===== Magento使用常见问题 =====

==== 新增的产品在前端看不到 ====

解决方案：确保产品的Stock Status是In Stock
知识库｜湖南麓川信息科技有限公司

User Tools

Site Tools

Page Tools
