Table of Contents 由 DocToc 生成
创建一个新文件夹, 此文件夹用来存放 phphub 开发相关的代码和虚拟机配置
mkdir phphub.org
cd phphub.org
在 phphub.org 文件夹下:
git clone https://github.com/summerblue/phphub
本项目使用 Laravel Homestead , 利用 VirtualBox 和 Vagrant 来统一开发环境.
在这里下载 VirtualBox , Vagrant
执行以下命令添加 box
vagrant box add laravel/homestead
https://vagrantcloud.com/laravel/homestead/version/8/provider/virtualbox.box
下载后执行以下命令, 注意修改 /path/to/virtualbox.box 为正确的 path.
vagrant box add laravel/homestead /path/to/virtualbox.box
在文件夹 phphub.org 下克隆 homestead 项目到本地
git clone https://github.com/laravel/homestead.git Homestead
根据你的情况修改 Homestead 项目里面文件 Homestead.yaml , 类似以下
---
ip: "192.168.10.10"
memory: 2048
cpus: 1
authorize: /Users/charliejade/.ssh/id_rsa.pub
keys:
- /Users/charliejade/.ssh/id_rsa
folders:
- map: /Users/charliejade/Projects/phphub.org/phphub
to: /home/vagrant/phphub
sites:
- map: phphub.app
to: /home/vagrant/phphub/public
variables:
- key: APP_ENV
value: local
sudo vi /etc/hosts
添加以下一行
127.0.0.1 phphub.app
cd Homestead
vagrant up
以上配置正确的话会有类似以下输出
➜ Homestead git:(master) ✗ vagrant up
Bringing machine 'default' up with 'virtualbox' provider...
==> default: Importing base box 'laravel/homestead'...
==> default: Matching MAC address for NAT networking...
==> default: Setting the name of the VM: Homestead_default_1407410586606_38332
==> ... etc....
==> default: php5-fpm stop/waiting
==> default: php5-fpm start/running, process 1945
测试是否能成功连接, 虚拟机里的 ~/phphub 文件夹里的文件和本地的文件是一致的.
vagrant ssh
cd ~
cd phphub
ll
浏览器访问 http://phphub.app:8000/ .
至此, 成功安装.
这时 phphub.org 的文件夹结构如下:
➜ ls
Homestead phphub
可以在 dotfile 里面增加 alias 进行快速连接 vm
alias vm="ssh vagrant@127.0.0.1 -p 2222"
这样以后直接使用 vm 就可进入 虚拟机了.
vm 进入虚拟机以后, 查看 php 版本
vagrant@homestead:~$ php -v
PHP 5.5.15RC1 (cli) (built: Jul 15 2014 11:14:55)
Copyright (c) 1997-2014 The PHP Group
Zend Engine v2.5.0, Copyright (c) 1998-2014 Zend Technologies
with Zend OPcache v7.0.4-dev, Copyright (c) 1999-2014, by Zend Technologies
with Xdebug v2.2.5, Copyright (c) 2002-2014, by Derick Rethans
查看版本
vagrant@homestead:~$ mysql --version
mysql Ver 14.14 Distrib 5.5.38, for debian-linux-gnu (x86_64) using readline 6.3
vm 下命令行链接, 密码为 secret
mysql -uhomestead -p
默认提供 homestead 数据库
mysql> show databases;
+--------------------+
| Database |
+--------------------+
| information_schema |
| homestead |
| mysql |
| performance_schema |
+--------------------+
4 rows in set (0.00 sec)
顺便创建数据库 phphub
mysql> create database phphub;
Query OK, 1 row affected (0.00 sec)
利用 laravel 4.1 有一个很贴心的功能, 允许自定义设置项目环境变量, 具体功能见 这里 .
在 app/config/database.php 文件里使用环境变量来控制数据库连接信息
'mysql' => array(
'driver' => 'mysql',
'host' => getenv('DB_HOST'),
'database' => getenv('DB_NAME'),
'username' => getenv('DB_USERNAME'),
'password' => getenv('DB_PASSWORD'),
'charset' => 'utf8',
'collation' => 'utf8_unicode_ci',
'prefix' => '',
),
在项目的根文件下创建文件 .env.local.php 文件, 参照根目录下文件 env.example.php:
<?php
return [
'DB_HOST' => 'localhost',
'DB_NAME' => 'phphub',
'DB_USERNAME' => 'homestead',
'DB_PASSWORD' => 'secret',
];
本机连接 vm 里面的 mysql 方法是:
host: 127.0.0.1
port: 33060
user: homestead
pass: secret
关于 vm 里面其他服务的 port 信息请见 文档
vm 到虚拟机下
cd ~/phphub
composer install --prefer-dist
注:
--prefer-dist会加快下载速度.
vm 下执行以下命令
cd ~/phphub
php artisan migrate --seed
创建 .env.testing.php 文件, 内容和 .env.local.php 一样.
在根目录下直接运行, 可以见 codecept 的用法
vendor/bin/codecept
运行测试
vendor/bin/codecept run
我们使用 Gulp 自动化的工具来做 scss 编译, 文件合并 etc... , 项目地址
Homestead 里已经安装了 nodejs , npm, gulp.
这里我们只需要做些配置就行.
进入 vm
vm
cd ~/phphub
npm install
在 vm 项目文件夹中运行 gulp 命令, 开始运行自动化脚本
vagrant@homestead:~/phphub$ gulp
[05:13:11] Using gulpfile ~/phphub/Gulpfile.js
[05:13:11] Starting 'watch'...
[05:13:11] Finished 'watch' after 8.76 ms
[05:13:11] Starting 'default'...
[05:13:11] Finished 'default' after 6.37 μs
注意:
/public/css和public/js文件夹为自动生成的文件, 请修改app/assets/下的文件.
- generator 快速构架代码的工具;
- codeception 用于 BDD (behavior-driven development) 测试, 快速入门在这 Quick Start ;
- clockwork 集成在 chrome 的 debuger 里面, 方便调试, 尤其是 sql 的可视化;
- laracasts/TestDummy 生成假数据, 在写测试的时候很方便;
- faker 假数据生成, 这是在
seed数据的时候使用; - ...
模版文件放置于 app\view 文件夹下, 结构大致如下:
➜ tree
.
├── auth
│ ├── loginrequired.blade.php
│ └── signupconfirm.blade.php
├── emails
│ └── auth
│ └── reminder.blade.php
├── layouts
│ ├── default.blade.php
│ └── partials
│ ├── errors.blade.php
│ ├── nav.blade.php
│ └── sidebar.blade.php
├── pages
│ ├── about.blade.php
│ ├── home.blade.php
│ ├── partials
│ └── wiki.blade.php
├── topics
│ ├── create.blade.php
│ ├── edit.blade.php
│ ├── index.blade.php
│ ├── partials
│ │ ├── filter.blade.php
│ │ ├── replies.blade.php
│ │ └── topics.blade.php
│ └── show.blade.php
└── users
└── index.blade.php
layouts放页面框架的模版文件;- 二级目录下
partials放页面的块模版文件, 利用好partials可以让模版文件更加简洁;
跟踪
composer.lock的好处是当你执行composer update的时候, 有些package会更新, 有时候这个更新会威胁到项目的稳定性, 这个时候如果有这个文件来跟踪刚刚到底更新了哪些package, 之前可用的package是哪个版本的话, 会很有帮助.
同时可以发现文件 .env.local.php 并不会被加入到 git 的版本控制里面.