对于如何创建一个laravel项目,相信对新接触laravel的朋友并不存在太多的问题,但是今天我们要来看一下如何将已有的laravel项目迁移(复制)到新的开发环境。

我们需要用到的工具是git,如果你不知道git是什么,这里有一个传送门,看完之后再回来:

简单说来,git就是github开发的vcs(version control system),即版本控制系统。如果你使用过svn,那么你应该很清楚版本控制是什么。

本文的示例环境是ubuntu 16.04 lts,windows的朋友可以在git bash下进行操作。

为了便于理解和操作,我会在本地系统环境下进行演示,如果项目在服务器端也没关系,我在文中会提到具体操作。

假设我们已经创建好了一个项目,项目地址为/home/eagle/webdev/example,

我们先来讲解一下整体步骤:

  1. 在项目文件夹中初始化git并将所有项目文件添加至working tree。
  2. 使用git clone命令克隆项目至新地址。
  3. 配置laravel并重新安装dependencies

步骤很明确,那么我们就开始。

首先我们进入本地项目文件夹,初始化git:

$ cd /home/eagle/webdev/example         
$ git init         
$ git add .         
$ git commit -m "initial commit"

这样一来,我们就可以使用git clone来拷贝我们的项目了:

$ git clone /home/eagle/webdev/example /home/eagle/webdev/new_location

完成后,我们的项目就顺利被迁移至了新的文件夹中。

那么如果我们的项目文件不在本地呢,而在远端服务器呢?

这里我们分为两种情况。

第一,如果你使用了github的repository,那么你的项目地址类似于以下地址

https://github.com/eagle/example.git

那么我们要克隆项目的话,可以直接使用以上地址:

$ git clone https://github.com/eagle/example

第二种情况,我们用了自己的服务器部署git server。这种情况稍微复杂一点,我们需要获取服务器的公共ip(public address)。假设我的服务器公网ip是50.100.150.260,我的项目地址为/srv/git/example.git,那么我们要克隆项目,需要使用以下地址:

git@50.100.150.260:/srv/git/example.git

注意这里git是我们在部署git server时所创建专门用于git的用户。

克隆命令并没有变化:

$ git clone git@50.100.150.260:/srv/git/example.git

只是地址变更了而已。

好了,那么我们克隆完成之后,我们就需要进行下一步了。

首先我们需要先运行

$ composer install

来安装项目需求的包裹。因为在git clone时,位于vendor文件夹下的包裹将不会被拷贝,所以我们需要重新安装这些包裹。

完成之后,我们需要创建.env环境文件。

可能你已经注意到,我们新建laravel项目的时候,.env文件将自动被创建在项目根目录下。但是这个文件是用于不同环境下项目配置的,所以在git clone时这个文件同样不会被拷贝至新路径。

好在laravel自带了一个.env文件的样本,来提供我们一个基础的配置模板:

$ cp .env.example .env

现在我们有了.env环境配置文件,我们需要生成新的app key:

$ php artisan key:generate

接下来打开.env文件,你会发现app_key一行已经自动填入了我们刚刚生成的key。

接下来我们将数据库信息填入相应的位置:

[…]                

db_connection=mysql                    

db_host=127.0.0.1                    

db_port=3306                    

db_database=eagle                    

db_username=homestead                    

db_password=secret                  

[…]

我们看到,db_database一行,我们填入该环境下数据库名称,db_username及db_password一行,我们分别填入管理该数据库的用户名和密码。

好了,现在我们保存文件。如果你有数据库迁移文件(migration),那么现在可以运行

$ php artisan migrate

来进行数据库的迁移,如果有种子文件(seeder)的话,继续运行

$ php artisan db:seed

进行seeding即可。

当然以上两个命令可以合并:

$ php artisan migrate --seed

注意,原始项目数据库里除了使用seeder生成的数据仍然需要自行拷贝至新的数据库。

好了,这样一来我们后端的配置就完成了,如果你用了laravel mix来编译前端文件,那么你还需要

$ npm install

注意:windows环境下请运行npm install –save-dev –no-bin-links

最后要说的一点,如果你是迁移到服务器环境下,那么你需要将storage文件夹及其包含的文件进行权限的调整:

$ chown -r www-data: storage

否则可能出现相应权限的错误。具体的权限调整请根据你环境的具体情况进行。

好了,现在我们已经成功地将laravel迁移至了新的开发环境!

本文主地讲解了如何使用git迁移laravel项目至新开发环境的步骤详解,更多关于laravel框架的使用技巧请查看下面的相关链接