PHP Laravel NGINX html css Bootstrap Python Symfony Apache Windows linux jquery Django ASP vanilla Slim vagrant docker Homestead MySQL Redis Git SVN ssh Root vim PhpStorm Pycharm sass less PHP Laravel android html css Vue Angular React NGINX html css Javascript

将Laravel项目迁移至新开发环境的步骤详解

原创

原创不易 ~ 转载请注明出处哦

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

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

http://github.com

Github鼎鼎大名我想大家都听说过,没有听说过的朋友,请出门左转自助面壁1分钟。
简单说来,git就是Github开发的VCSVersion Control System),即版本控制系统。如果你使用过SVN,那么你应该很清楚版本控制是什么。

本文的示例环境是Ubuntu 16.04 LTSWindows的朋友可以在Git bash下进行操作。至于如何在Windows操作系统下搭建Laravel的开发环境,请参考

Windows 7/8/10 系统下Laravel框架的开发环境安装及部署详解(Vagrant + Homestead)

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

假设我们已经创建好了一个项目,项目地址为/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 init

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

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

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

git clone

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

这里我们分为两种情况。
第一,如果你使用了GithubRepository,那么你的项目地址类似于以下地址

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

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

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

第二种情况,我们用了自己的服务器部署Git Server。这种情况稍微复杂一点,我们需要获取服务器的公共ippublic address)。假设我的服务器公网ip50.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_USERNAMEDB_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迁移至了新的开发环境!


正在加载验证码......
请先完成验证