Laravel框架学习笔记——Laravel环境配置及安装（Ubuntu20.04为例）

引言

好久没写博客了，因为个人需要， 所以要涉及到Laravel框架的学习，所以会出一系列的关于PHP的Laravel框架学习笔记，希望能够帮助到有需要的人。本系列所有的内容，都以官网中文文档为准进行学习，我使用的系统是Ubuntu20的虚拟系统。

1、安装Nginx

因为我个人是喜欢Nginx作为代理服务器，所以选择Nginx进行安装。如果要选用Apache的可以自行安装，先安装代理再执行其他的步骤。

sudo apt-get update #更新应用源
sudo apt-get upgrade #对系统安装程序进行更新
sudo apt-get nginx #安装nginx

nginx的版本不用追求高，选择稳定版本即可。

2、安装PHP

我服务器使用Nginx，所以安装php-fpm，但是因为框架版本选择的是Laravel9，Laravel9的先决前提是PHP版本>=8.0，如果你是阿里云Ubuntu 20 LTS，就不用升级服务器了，不然需要升级一下才有PHP8;

sudo apt install software-properties-common 
sudo apt-add-repository ppa:ondrej/php # 添加php源地址
sudo apt-get update

然后进行php的安装，以及所需的插件安装，如下

sudo apt-get install php8.0-fpm php8.0-mysql php8.0-gd php8.0-mbstring php8.0-bcmath php8.0-xml php8.0-curl php8.0-redis php8.0-opcache php8.0-odbc

在这里我遇到了一个问题

Cannot initiate the connection to ppa.launchpad.net:80 (2620:2d:4000:1::3e). - connect (101: Network is unreachable) [IP: 185.125.190.52 80]
Fetched 4,965 kB in 3min 27s (24.0 kB/s)

这是用使用sudo apt-get update也没用，也是超时

可以通过增加超时和重试来使其工作：

sudo apt-get update --option Acquire::Retries=100 --option Acquire::http::Timeout="120"

然后再执行安装命令就可以安装成功了php -v检查是否安装成功

设置开机自启以及查看状态

systemctl status php8.0-fpm
systemctl enable php8.0-fpm

3、安装Composer

Composer是 PHP 用来管理依赖（dependency）关系的工具。你可以在自己的项目中声明所依赖的外部工具库（libraries），Composer 会帮你安装这些依赖的库文件。
这里我们安装composer就完全参照官方文档
安装前一定要先安装好php
下载安装脚本 － composer-setup.php － 到当前目录。

php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"

执行安装过程。

php composer-setup.php

上述所示就是安装成功了

删除安装脚本。

php -r "unlink('composer-setup.php');"

接下来直接进行全局安装，这样使得在命令窗口中可以直接使用composer

sudo mv composer.phar /usr/local/bin/composer

上述步骤执行完毕后，键入composer -V查看是否已经安装配置成功。

yby@ubuntu:~$ composer -V
Composer version 2.5.4 2023-02-15 13:10:06

最后，因为composer的源默认是国外的，使用国外源安装插件都可能比较慢，参照官方文档，可以换源，但是我换完源后下面安装Laravel安装器失败了，这个，大家慎重吧。如果大家换成国内源安装东西失败了，可以换回来，或者换成阿里云镜像源（真好用，推荐阿里云）。步骤都在下面了。

composer config -g repo.packagist composer https://packagist.phpcomposer.com #国内源
composer config -g repo.packagist composer https://packagist.org #官方国外源
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ #阿里云镜像

至此composer安装完成，最后不要忘了经常执行 composer selfupdate 以保持 Composer 一直是最新版本。

4、搭建Laravel框架项目

参照官网给出的文档，我们可以直接使用composer进行搭建，但是每次都要输入一长串指令有些麻烦，所以我们可以先安装Laravel安装器，然后通过Laravel安装器安装。

通过Composer安装laravel安装器

composer global require laravel/installer

安装成功。
但是呢，执行laravel -v时提示laravel not found
看了一下官方文档

晕死，还要自己设置一下环境变量，执行下述命令

export PATH="$HOME/.config/composer/vendor/bin:$PATH";

然后再执行laravel -v可以看到如下提示则成功

OK。接下来进入/var/www/目录下，该目录是安装nginx时自动创建的目录，在该目录下创建新的Laravel项目。

laravel new example-app

产生了如下问题，权限不够，于是该给/var/www/文件夹更改权限

sudo usermod -aG www-data $USER #创建一个www-data用户组，将自己加入用户组中
sudo chown -R www-data:www-data /var/www #给文件夹用户组权限
sudo chown -R $USER:$USER /var/www #给自己操作文件夹的权限

这两句执行完后，再执行下载命令即可laravel new example-app，等待安装即可

然后进入example-app,测试执行即可

cd example-app
php artisan serve

浏览器打开8000端口就行

这样一个Laravel环境就搭建完成了，可以安装mysql数据库等，进行开发。

5、修改Nginx映射

这里配置映射为了让前端页面能够访问到接口，或者让别人能够访问网页，需要修改Nginx配置，我是Ubuntu20.04的系统，所以Nginx的配置位置在/etc/nginx/sites-available/default，键入命令打开配置文件
没有vim的可以先安装vim，这是一个文件编辑软件

sudo apt-get install vim #安装vim
vim /etc/nginx/sites-available/default #编辑配置文件

键入i，然后删除文件内所有内容，复制官网的配置即可。

直接整个复制到刚才打开的文件里
然后修改 server_name后的内容改成下划线，这样不管是IP还是域名都能访问。root后改成刚才我们在/var/www文件夹下新安装的laravel项目的public位置，public文件内存的就是项目编译后产生的php文件。

按下Esc键，输入:wq保存退出，改了配置后重启nginx服务

service nginx restart

然后进入example-app目录执行上面的启动命令，浏览去输入localhost查看，但是我这里，如果输入:8000也就是laravel默认运行端口，则可以正常打开，但是我用localhost，即80端口映射访问时就不行，报错权限问题如下

发现这里还需要给刚生成的example-app项目文件设置权限，下面操作都用一下，问题不大

sudo chown -R www-data:www-data /var/www/example-app/
sudo chmod -R 775 /var/www/example-app/storage/
sudo chmod -R 775 /var/www/example-app/bootstrap/cache

然后运行，我们在localhost就可以正常打开了

6、安装MySQL

因为我们装的是Laravel9，所以按照官方文档，需要安装的MySQL版本需要在5.7以上

直接安装8.0好了，因为MySQL在Ubuntu20.04操作系统上不再发布MySQL5.7版本的，换源下载麻烦，直接安装8.0版本

sudo apt update
sudo apt-get install mysql-server

安装完后键入mysql -V查看版本，出现版本号就是安装成功

狗屎啊，真的是依托答辩，居然不提示我设置密码，据说是默认密码123456，然是也进不去，就必须要前面键入sudo命令才能进入，如下所示


简直依托答辩，治理直接超级管理员权限进去，键入命令，设置密码

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '1234';

然后ctrl+z推出，重新试一下

哎嗨，进来了，搞定搞定，设置一下开机自启就可以了，环境差不多结束。

systemctl enable mysql

搞定，下期再见。