MAC 安装 Magento2 community edition 详细步骤
花了好幾天時(shí)間,終于在Mac OS X EI Capitan上成功安裝magento2.1.1. 此處詳細(xì)記錄每個(gè)步驟,以備未來(lái)使用。
參考magento官方指南:(Easy) Install the Magento archive on your server
1. 確保系統(tǒng)滿足prerequisite:
建議不要使用XAMPP(我用XAMPP無(wú)論如何PHP的intl extension都顯示沒(méi)有enable),就自己一步一步配置php+mysql+apache。
具體要求如下:system requirement
這一步非常非常重要,我在第一次安裝的時(shí)候,偷懶沒(méi)有確保prerequisite,遇到各種問(wèn)題,一個(gè)接一個(gè),不間斷的。所以這一步一定要先認(rèn)真仔細(xì)配置好!
以下是我遇到各種問(wèn)題的截圖以及解決方案。簡(jiǎn)直是血和淚的教訓(xùn):
1.1 MySQL error:
1.1.1 原因:mysql版本太老:
命令行中運(yùn)行mysql --version可以查看version。(此截圖是進(jìn)入mysql命令行工具后的截圖):
1.1.2 解決方案: 安裝mysql5.7:
推薦mysql官網(wǎng)這個(gè)鏈接(download mysql)下載最后一個(gè).dmg文件,雙擊安裝即可。
安裝完成后,mysql后給一個(gè)自動(dòng)生成的密碼,需要修改。修改command比較簡(jiǎn)單,google就可以了。
更新完成后,mysql變成了5.7.15版本:
1.2 php extension error:
1.2.1 原因:PHP版本太老.
查看當(dāng)前PHP版本,在命令行中運(yùn)行 php -v:
1.2.2 解決方案:更新到PHP7.0.11:
這一步遇到了比較大的困難,具體步驟參考我另一篇博客:MAC 更新 PHP 指南 以及 PHP常用命令示例
更新完成后,PHP變成了7.0.11版本:
1.3 Admin page not found error:
1.3.1 原因
沒(méi)有enable apache mod_rewrite module
1.3.2 解決方案?
具體解決步驟在本文后面部分講解
2. 開(kāi)始安裝
2.1 獲取初始文件
兩種方式:1.下載打包好的文件 2.使用git clone magento repository
推薦使用第2種方式。因?yàn)樵赾lone repo到本地后,可以隨意選擇想要安裝的版本。
Magento2的github repo地址是:https://github.com/magento/magento2
在terminal中進(jìn)入想要安裝magento的文件夾,輸入:
git clone https://github.com/magento/magento2.git成功clone repo之后,要注意的是default branch是develop。這時(shí)需要自己選擇想要安裝的magento版本。例如在我clone時(shí),develop是magento2.2.0-dev版本。但是我想要最新的穩(wěn)定版本。可以查看releases:?magento releases:
如上圖所示,最新的release版本是Magento 2.1.1, tag是2.1.1.于是在terminal中輸入:
git checkout tags/2.1.1命令運(yùn)行之后,本地的Magento就是2.1.1版本了。
2.2 修改文件夾權(quán)限
如果之前沒(méi)配置好權(quán)限,在瀏覽器中,輸入自己的localhost加上magento文件夾具體地址,會(huì)得到以下error:
需要修改文件夾權(quán)限,magento user需要對(duì)文件夾以及子文件夾和文件有read&write權(quán)限。
具體步驟參看我的另一篇博客:MAC 修改文件夾以及子文件夾和子文件權(quán)限 以及 修改文件夾owner
2.3 Lauch magento setup guide
2.3.1 Readiness Check
此時(shí)再在瀏覽器中輸入magento的文件夾路徑, setup就啟動(dòng)了。第一部步eadiness check, 我得到以下error:
2.3.1.1 原因
上一步設(shè)置好的權(quán)限,并沒(méi)有對(duì)[your_magento_main_folder}/var/.DS_Store文件生效。
2.3.1.2 解決方案
按照上一步的方法,單獨(dú)修改.DS_Store文件的權(quán)限。
2.3.1.3 驗(yàn)證成功
權(quán)限問(wèn)題解決后,第一步readiness check成功:
2.3.2 Add a Database
輸入數(shù)據(jù)庫(kù)信息后,得到以下error:
2.3.2.1 原因
還沒(méi)創(chuàng)建magento211數(shù)據(jù)庫(kù)
2.3.2.2?解決方案
登錄mysql創(chuàng)建magento211數(shù)據(jù)庫(kù)。進(jìn)入mysql command line后,輸入:
create database magento211
2.3.3 其他步驟
接下來(lái)的步驟,都沒(méi)出什么問(wèn)題,就截圖記錄一下:
3.安裝成功,開(kāi)始使用
就在我以為終于安裝成功,可以松口氣,開(kāi)心地點(diǎn)擊了上圖的“Lauch Magento Admin”按鈕后。。。
3.1 Admin page not found error
3.1.1 原因
apache需要enable rewrite module
3.1.2 解決方案
- 打開(kāi)/etc/apache2/httpd.conf 文件。
- 確保以下行沒(méi)有被注釋掉:LoadModule rewrite_module libexec/apache2/mod_rewrite.so
- 確保在<Directory "[your server root directory]"></DIrectory>里面, AllowOverride All
3.2 頁(yè)面沒(méi)有style和圖片
3.2.1 原因 沒(méi)有deploy static content 3.2.2 解決方案 warning: bin/magento命令會(huì)修改文件夾權(quán)限。所以在每次運(yùn)行完命令后,進(jìn)入下一步可能會(huì)報(bào)錯(cuò)。遇到permission error,只需要把文件夾權(quán)限設(shè)置回read&write就可以了。 打開(kāi)terminal,輸入: php bin/magento setup:static-content depoly
3.2.3 驗(yàn)證解決成功 刷新頁(yè)面,style和圖片就應(yīng)該都有了:
如果還是沒(méi)有static content,可以嘗試在terminal中運(yùn)行以下兩行命令: php bin/magento cache:flush php bin/magentoindexer:reindex
4 小提示 4.1 develop環(huán)境下,開(kāi)啟exception printing 以方便查看error信息。推薦按照這篇博文配置:Magento exception printing is disabled by default for security reasons – How to fix?
4.2 Disable Xdebug
4.2.1 遇到問(wèn)題:Allowed memory size exhausted error
我是先安裝了沒(méi)有sample data的magento。然后再根據(jù)官方指南Install sample data by cloning repositories?安裝sample data。
安裝成功后,需要compile代碼。于是我在terminal中輸入以下命令行:
bin/magento setup:di:compile
然后出現(xiàn)PHP Fatal error: Allowed memory size exhausted:
4.2.2 原因
enable xdebug會(huì)消耗更多的memory
4.2.3 解決方案
disable xdebug。 參考我的另一篇博文:MAC PHP7 如何disable xdebug?
總結(jié)
以上是生活随笔為你收集整理的MAC 安装 Magento2 community edition 详细步骤的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇: linux部署redis集群遇到的问题
- 下一篇: MySQL各个版本区别