macOS搭建php环境以及调试Symfony
- macOS搭建php环境以及调试Symfony
- 古老的传说
- 运行环境
- 快速前置安装环境
- [php 的安装](#php 的安装)
- [安装 Xdebug 来调试 php](#安装 Xdebug 来调试 php)
- [如何找到你的 php.ini](#如何找到你的 php.ini)
- [Xdebug 安装成功](#Xdebug 安装成功)
- [创建并调试的 Hello world](#创建并调试的 Hello world)
- [安装 PHP Debug](#安装 PHP Debug)
- [安装 Symfony](#安装 Symfony)
- [安装 Composer](#安装 Composer)
- [安装 Symfony CLI](#安装 Symfony CLI)
- [创建 Symfony App](#创建 Symfony App)
- 添加路由
- 调试路由
- 结尾
古老的传说
神说:要有光,于是世界就有了光。
神说:要有语言,于是世界就有了php
。
在世界上下 5000
年的历史长河中,
有这么一句古话镌刻在我们全人类心中:
"php是世界上最好的语言"
运行环境
最近,我,一名 Nodejs Developer
, 出于来 php
生态取取经这个目的,我开始学习 php
框架 Symfony
而且我也喜欢
Symphony
这首歌,于是一边写代码写这篇文章,一边开始了我的Clean Bandit
循环。
本文的运行环境如下:
macOS
14.3.1vscode
1.87.2
除此之外不需要安装其他任何软件 (比如: XAMPP
,Laragon
)
快速前置安装环境
php
经过这么多年的发展,早就已经非常的成熟了。所以安装调试它非常的简单。
php 的安装
首先去 php.net 按照 macOS 系统下的安装文档 安装一下 php
记得先安装
homebrew
: https://brew.sh/
sh
brew install php
安装就好了, php -v
一下,出现以下信息:
txt
PHP 8.3.4 (cli) (built: Mar 12 2024 23:42:26) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.3.4, Copyright (c) Zend Technologies
安装 Xdebug 来调试 php
调试 php
需要 xdebug
, 去 xdebug.org 按照教程安装一下
sh
pecl install xdebug
安装好了之后,默认情况它会自己去修改你的 php
目录下的 php.ini
添加一行:
txt
zend_extension="xdebug.so"
当然假如没有的话,你也可以手动去 php.ini
添加下这一行。
如何找到你的 php.ini
你可以通过 php --ini
命令找到你文件的路径:
sh
php --ini
# 然后展示你php的路径信息,类似下方
Configuration File (php.ini) Path: /opt/homebrew/etc/php/8.3
Loaded Configuration File: /opt/homebrew/etc/php/8.3/php.ini
Scan for additional .ini files in: /opt/homebrew/etc/php/8.3/conf.d
Additional .ini files parsed: /opt/homebrew/etc/php/8.3/conf.d/ext-opcache.ini
Xdebug 安装成功
此时假如 xdebug
安装注册成功的话, 执行 php -v
会额外出现信息:
sh
PHP 8.3.4 (cli) (built: Mar 12 2024 23:42:26) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.3.4, Copyright (c) Zend Technologies
# 注意下一行 Xdebug
with Xdebug v3.3.1, Copyright (c) 2002-2023, by Derick Rethans
with Zend OPcache v8.3.4, Copyright (c), by Zend Technologies
创建并调试的 Hello world
随便在哪创建一个目录,在这打开 vscode
然后创建一个 test.php
,内容如下:
php
<?php
$a = 0.1;
$b = 0.2;
$c = $a + $b;
$isEqual = $c == 0.3;
var_dump($isEqual);
$author = "'🧊 ice breaker 🧊'";
$cow = '\'Hello World\' from ';
$helloWorld = $cow . $author;
echo $helloWorld;
执行 php -f test.php
运行一下看看结果
安装 PHP Debug
然后安装 PHP Debug
vscode
扩展:
安装好了,就可以创建 .vscode/launch.json
并在其中添加,调试 php
的启动方式了。
我们在这个 json
文件的 configurations
字段中,随便输入个 php
就自动联想出来调试 php
的各种方式了, 比如下方这端就是插件自动生成的:
json
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch currently open script",
"type": "php",
"request": "launch",
"program": "${file}",
"cwd": "${fileDirname}",
"port": 0,
"runtimeArgs": ["-dxdebug.start_with_request=yes"],
"env": {
"XDEBUG_MODE": "debug,develop",
"XDEBUG_CONFIG": "client_port=${port}"
}
}
]
}
这个生成的调试命令的作用,点击 vscode debug
之后快速调试,你右边编辑器打开的 php
文件的。
我们打开 test.php
测试一下吧!
命中断点!同时各位写 js
的同学,看到这个结果,不免会心一笑,弱类型解释型之殇哈哈。
不懂这个梗的,可以去浏览器的开发者工具控制台,执行一下
0.1 + 0.2
不过现在 php
是可以强类型的,只是我这里没有显式声明罢了。
这样就初步完成了调试 php
脚本的工作。
安装 Symfony
去 symfony.com 按照教程安装一下
我们已经安装好了 php
了,现在就只需要安装 Composer
和 Symfony CLI
就可以了
安装 Composer
Composer
是一个安装 php
包的工具,我就把它理解成 npm
了
来到 getcomposer.org 按照安装命令执行,就安装成功了
此时一个全局命令 composer
会被注册在你的 zsh
,执行 composer --version
来看看是否安装成功吧!
sh
composer --version
# 安装成功展示以下信息
Composer version 2.7.2 2024-03-11 17:12:18
PHP version 8.3.4 (/opt/homebrew/Cellar/php/8.3.4/bin/php)
Run the "diagnose" command to get more detailed diagnostics output.
我在有
composer.json
的php
项目里执行composer i
,然后生成了composer.lock
文件和vendor
,var
文件夹。而你在有
package.json
的nodejs
项目里执行npm i
/yarn
/pnpm i
不也是生成lock
文件和node_modules
文件夹吗?不过
node_modules
是 "扭曲时间和立场的黑洞",不知道vendor
是不是,笑~
安装 Symfony CLI
同样使用 Homebrew
:
sh
brew install symfony-cli/tap/symfony-cli
安装完成之后执行:
sh
symfony check:requirements
看到以下信息你就完成Symfony
环境搭建的工作了!
sh
Symfony Requirements Checker
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> PHP is using the following php.ini file:
/opt/homebrew/etc/php/8.3/php.ini
> Checking Symfony requirements:
......................................
[OK]
Your system is ready to run Symfony projects
Note The command console can use a different php.ini file
~~~~ than the one used by your web server.
Please check that both the console and the web server
are using the same PHP version and configuration.
创建 Symfony App
执行:
sh
symfony new symfony-ms-demo --version="7.0.*"
创建了一个现代化的 symfony
应用,然后 cd
& compose i
之后
执行 symfony server:start
开跑:
访问对应页面出现:
成功运行了,就是这么简单!
添加路由
按照教程在 src/Controller
添加一个 LuckyController.php
:
php
<?php
namespace App\Controller;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;
class LuckyController
{
#[Route('/lucky/number')]
public function number(): Response
{
$number = random_int(0, 100);
return new Response(
'<html><body>Lucky number: ' . $number . '</body></html>'
);
}
}
嗯,看代码是返回一个 html
字符串,这种代码实在是太常见了,各个语言的 web
框架不都是这样的吗?接口那种 CRUD
也不过是做点事情返回点 json
/xml
啥的,
什么概念比如 Middleware
,Pipe
什么 Controller
,Service
, Guard
, Interceptor
, Decorator
, Module
,Provider
,Inject
,IOC/DI
...早已经了然于胸,不都是这些玩意,或者那些架构嘛...
说远了,我们注册了这个路由之后,访问 symfony server:start
host
路由的 /lucky/number
地址,就是返回上面那个 html
片段了,但是我们应该怎么调试呢?
调试路由
实际上也很简单,同样使用 Xdebug
即可
我们同样在 .vscode/launch.json
添加一种启动方式: (输入 php
自动感应生成)
jsonc
{
"configurations": [
{
"name": "Launch Built-in web server",
"type": "php",
"request": "launch",
"runtimeArgs": [
"-dxdebug.mode=debug",
"-dxdebug.start_with_request=yes",
"-S",
"localhost:0",
],
"program": "",
// 只需要设置下一行的 cwd,指向你 symfony 应用的入口 index.php 即可
"cwd": "${workspaceRoot}/symfony-ms-demo/public",
"port": 9003,
"serverReadyAction": {
"pattern": "Development Server \\(http://localhost:([0-9]+)\\) started",
"uriFormat": "http://localhost:%s",
"action": "openExternally",
},
},
],
}
然后在 vscode
里面直接启动,访问对应的路由即可命中断点:
结尾
不知不觉就水了这么长的文章了,看都看累了
本文主要在讲如何在 vscode
里面运行和调试 php
以及 php
web
框架 Symfony
,算是基础中的基础了。
至于其他的软件, 比如 XAMPP
,Laragon
啥的,我个人感觉是没有必要的,因为这种都可以使用 Docker
作为代替,切换 php
版本不过也只是拉不同的 php
版本镜像拉下来,在容器里去进行开发和运行罢了。
不过随着开发的深入,我感觉 XAMPP
,Laragon
啥的这种还是有必要的。
因为我内存不够用了!!!
所以奉劝各位,买 Macbook Pro
的时候,一定要买大点的内存,尤其是你要本地跑容器的,推荐 36GB
起。(不过苹果内存真的是贵啊)