document.writeln('');
当前位置:首页 > 云服务器

单台云服务器从零搭建Hyperf项目完整流程

游戏科技网2026年09月15日 01:10云服务器70
必须安装 hyperf/http-server 才能启动 HTTP 服务,否则 php bin/hyperf.php start 后无端口监听、curl 超时;安装后默认监听 0.0.0.0:9501,无需额外配置。

直接上手,不绕弯子。单台云服务器跑 Hyerf 项目,核心就四件事:连得上、装得对、跑得稳、访得着。中间没玄学,但有几个关键点容易卡住——比如没装 hyperf/http-server 就启动,看着进程在跑,其实根本没监听端口;又比如路由写了 /api/ 结尾斜杠,结果全 404。下面按真实操作顺序拆解。

连上服务器并初始化环境

买完服务器后,你会拿到公网 IP、用户名(一般是 root)、密码和 SSH 端口(默认 22)。

  • Windows 用户用 Xshell 或 FinalShell,填 IP、端口、用户名、密码,点连接就行
  • Mac / Linux 用户直接终端执行:ssh root@你的公网IP,输密码(输的时候不显示,正常)

首次登录后,先做三件事:

  • 更新系统:apt update && apt upgrade -y(Ubuntu)或 yum update -y(CentOS)
  • 装基础工具:apt install -y git curl wget unzip vim
  • 创建普通用户(安全起见):adduser deploy && usermod -aG sudo deploy,之后建议改用这个用户操作

装 PHP 环境和 Hyperf 骨架

Hyperf 要求 PHP ≥ 7.4(推荐 8.1+),且必须启用 sockets、pcntl、openssl、json 等扩展。别跳过验证:

  • 先装 PHP:apt install -y php8.1-cli php8.1-mbstring php8.1-xml php8.1-curl php8.1-sqlite3 php8.1-zip
  • 确认扩展已加载:php -m | grep -E "sockets|pcntl|openssl",缺哪个补哪个
  • 装 Composer:curl -sS https://getcomposer.org/installer | php && mv composer.phar /usr/local/bin/composer
  • 创建项目:composer create-project hyperf/hyperf-skeleton myapp

注意:骨架默认不含 HTTP 服务组件,必须手动装——否则 php bin/hyperf.php start 启动后 curl http://127.0.0.1:9501 会超时。

Hyperf 3.2.4

Hyperf 3.2.4 官方源码下载,适合 PHP 协程框架、微服务组件和高并发应用升级,覆盖 3.2 分支新增函数与稳定性优化。

下载
  • 进项目目录:cd myapp
  • 执行:composer require hyperf/http-server

配置与启动服务

Hyperf 默认监听 0.0.0.0:9501,但要让外网访问,还得打开防火墙端口,并确认服务真正跑起来了。

  • 开放端口(Ubuntu):ufw allow 9501;(CentOS):firewall-cmd --permanent --add-port=9501/tcp && firewall-cmd --reload
  • 启动服务:php bin/hyperf.php start(别 background 运行,先看日志是否报错)
  • 验证是否监听:netstat -tuln | grep :9501 或 ss -tuln | grep :9501
  • 本地测试:curl http://127.0.0.1:9501 应返回欢迎页或你写的响应

如果启动卡住或无响应,优先检查:

  • 端口是否被占:lsof -i :9501(Linux/macOS)或 netstat -ano | findstr :9501(Windows WSL)
  • 路由是否注册成功:php bin/hyperf.php route:list,确保你的控制器路径出现在列表里
  • AutoController 的 prefix 别加结尾斜杠,#[AutoController(prefix: /api)] 正确,/api/ 错误

让域名或 IP 直接访问

现在服务只在 9501 端口运行,浏览器输 http://你的IP:9501 才能访问。想用 http://你的IP 或域名直接打开,有两个轻量方案:

  • Nginx 反向代理(推荐):装 Nginx,配一个 conf 指向本地 9501:
    location / { proxy_pass http://127.0.0.1:9501; proxy_set_header Host $host; }
    然后开放 80 端口,重启 Nginx 即可
  • 改 Hyperf 监听端口(简单):编辑 config/autoload/server.php,把 port => 9501 改成 80,再启动(需 root 权限)

若要用域名,记得提前在 DNS 后台添加 A 记录指向服务器公网 IP,等解析生效(通常几分钟到几小时)。

“单台云服务器从零搭建Hyperf项目完整流程” 的相关文章

盘点最新优惠 云服务器网站推荐

盘点最新优惠 云服务器网站推荐 探盘最新优惠 云服务器网站推荐 云计算技术的迅猛发展,使得云服务器成为企业和个人开发者不可或缺的基础设施。云服务器,作为一种基于虚拟化技术的计算资源,允许用户按需获取计算能力、存储和网络资源,极大地提升了IT部署的灵活性和成本效益。近年来,随着数字化转型的加速,云服务器市场迎来了爆发式增长。根据Gartner的最新报告,全球公有云服务市场规模在2023年达到了497…

实惠低价云服务器f2g评测

实惠低价云服务器f2g评测 实惠低价云服务器F2G评测 随着云计算技术的快速发展,云服务器已经成为企业和个人开发者的重要选择。相比传统的物理服务器,云服务器在灵活性、可扩展性和成本上具有显著优势。然而,对于一些初创企业或个人开发者来说,选择一款性价比高、价格实惠的云服务器尤为重要。本文将对目前市场上较为热门的“实惠低价云服务器F2G”进行深入评测,从性能、稳定性、适用场景等多个维度进行分析,帮助用…

10Mbps云服务器实战指南

10Mbps云服务器实战指南 在当前数字化转型的大背景下,云服务器已成为企业信息化建设的重要基础设施。本文将围绕10Mbps云服务器的选购指南、配置优化、常见问题解决方案以及性能监控等方面,提供实用的建议和操作步骤,帮助用户高效部署并充分利用这一资源。 一、选购指南:如何根据业务需求选择合适的10Mbps云服务器? 1. 了解10Mbps带宽的实际应用 10Mbps云服务器适用于中小型企业网站、开…

云服务器免费使用活动全面开启

云服务器免费使用活动全面开启 嗨,大家好!我是小明,一个普通的大学生,去年还在为学校的创业项目发愁呢。那时候,我有个小想法:做个简单的网站,展示我们团队的环保APP概念。但问题是,我们连个像样的服务器都没有,每次在宿舍的电脑上测试代码,都卡得要死,感觉像在泥潭里爬行。我心想,如果能有个免费的东西试试就好了——谁知道呢,说不定一试就上瘾了。 那天,我在社交媒体上刷着朋友圈,突然看到一条消息:“云服务…

2021年最全云服务器优惠大揭秘

2021年最全云服务器优惠大揭秘 嗨,大家好,我是小明,一个普通的小白领,最近我打算自己建个网站分享旅行照片和心得。刚开始,我觉得这挺简单的,但一查资料,就陷入了云服务器的世界。哈哈,别笑,我刚开始也觉得云服务器是高科技的东西,搞得我一头雾水。不过,2021年的时候,各大云服务商推出了不少优惠套餐,让我这个新手觉得机会来了。你想知道2021年云服务器优惠套餐有哪些吗?让我来和你分享我的经历。 回想…

(html)如何发布_发布HTML文件到网络的方法【网络】

(html)如何发布_发布HTML文件到网络的方法【网络】

可通过四种方式将HTML文件部署为公开网站:一、GitHub Pages免费托管;二、云存储服务(如阿里云OSS)启用静态网站托管;三、VPS配置Nginx/Apache服务器;四、Netlify/Vercel无服务器快速部署。 如果您已创建好一个 HTML 文件,但希望他人能通过互联网访问它,则需要将该文件部署到可公开访问的服务器上。以下是实现此目标的多种方法: 一、使用 GitHub Pa…