前期准备

---

一、安装node与php环境

• node环境：建议使用n（windows）或者nvm （mac）从而方便灵活切换版本。
  1.安装好node环境
  2.安装gulp npm install -global gulp-cli
  3.导入项目后于项目根目录命令行下安装gulp依赖插件： npm install
  4.查看gulpfile.js，输入gulp xxx 即可运行名为xxx的gulp任务。
  node官网
  gulp用法教程

• php环境：windows下可用wamp，mac下可用xampp。
  wamp下载地址
  xampp下载地址

注意：安装完毕后可在命令行输入node检测node环境是否安装成功，或者打开浏览器输入localhost和127.0.0.1检测php环境是否安装成功。

二、从git上clone项目

三、导入数据库

使用环境集成包配置好环境后，用phpmyadmin之类的数据库管理工具，导入数据文件即可。
phpmyadmin本地网址一般为：http://localhost/phpmyadmin/

---

环境配置

---

一、 修改hosts文件

• windows：C:\windows\system32\drivers\etc 目录下
• mac： /etc/hosts
  在文件末尾添加以下两行：
  hosts配置样本.png

注意：修改hosts文件各个系统下均需要管理员权限。

二、配置虚拟目录

1.根据自己安装的集成环境，寻找到对应的apache的配置文件 httpd.conf ,搜索关键词:vhost。
找到所在行并去掉#Include conf/extra/httpd-vhosts.conf前面的#号。

2.打开apache的apache/conf/extra下的次配置文件httpd-vhosts.conf，在该文件末尾加上以下代码：
<VirtualHost *:80> DocumentRoot d:/wamp/website/a.com ServerName www.makeblock.edu <Directory "d:/wamp/website/a.com"> Options Indexes FollowSymLinks AllowOverride None Order allow,deny Allow from all </Directory> </VirtualHost>
注意：以上目录请更换成本地项目目录

备注：上一步操作后loaclhost可能访问不到，需要添加以下代码：
<VirtualHost *:80> DocumentRoot d:/wamp/www ServerName localhost <Directory "d:/wamp/www"> Options Indexes FollowSymLinks AllowOverride None Order allow,deny Allow from all </Directory> </VirtualHost>

注意：以上为windows环境下的配置，mac下可查看参考资料或点击此处

三、下载对应版本的opencart

1.从项目根目录下的index.php开头找到
define('VERSION', 'x.x.x.x');
下载对应版本的opencart即可
下载地址：https://www.opencart.com/index.php?route=download/download

2.下载完成后，解压出来，将其中upload/install文件夹复制到项目根目录中。

3.将upload/install/config-dist.php文件复制到本地项目根目录与admin目录中，并且统一重命名为config.php。

四、访问项目

此时打开浏览器，输入前面配置的虚拟目录域名： www.makeblock.edu，会自动跳转到安装提示页面，根据提示操作即可。
如果不能正确跳转到安装提示页面，请检查前几步配置是否配置正确。

五、局域网访问配置

1. 打开apache配置文件httpd.conf，找到Listen 80，在其后新增一行 Listen 9876。
   端口号可替换成任意空闲端口
   2.仿照** 二、配置虚拟目录 第2条** ，在httpd-vhosts.conf添加如下代码：
   <VirtualHost *:9876> ServerAdmin webmaster@makeblock.me DocumentRoot "/Users/strggle/git/Makeblock.com" ServerName / ErrorLog "logs/dummy-host2.example.com-error_log" CustomLog "logs/dummy-host2.example.com-access_log" common </VirtualHost>
   3.此时使用其他电脑通过访问 本机IP:端口 可访问到本机部署的项目，如果内部链接不正常（如链接域名不是本机IP），可修改项目根目录下的config.php前两句代码为：
   // HTTP define('HTTP_SERVER', ''); // HTTPS define('HTTPS_SERVER', '');

---

可能遇到的问题

• Q：安装提示页显示文件不可写入怎么解决？
  A：此时需要修改文件权限为可读写。

• Q: 为什么没有修改文件却显示文件已被修改？
  A：可能是批量修改文件权限被git检测到，可在项目根目录上输入命令git config core.filemode false，可设置忽略文件权限的检查。

• Q: 运行时提示fwrite() expects parameter 1 to be resource, boolean given in
  A: 可尝试修改system文件夹下的目录和文件权限为可读写

---

参考资料

• mac配置教程：
  http://www.cnblogs.com/heiniuhaha/archive/2011/10/14/2212478.html
• gulp用法
  http://www.techug.com/gulp