准备工作与环境要求
系统与版本要求
Windows 10/11 为最佳开发环境,兼容性更高、更新也更稳定;管理员权限账号可以确保安装过程不因权限不足而中断;PowerShell 5.0+ 是运行 Scoop 的基础,需要确保系统自带或已升级到较新版本;
在开始之前,请确保你的系统具备稳定的网络连接,以便从 Scoop 的镜像源下载安装包和清单文件;同时,确保机器的防火墙或代理设置不会拦截 get.scoop.sh 相关域名,以避免远程拉取失败。
网络与权限
为顺利安装 Scoop,终端以管理员身份运行是最稳妥的方式;如果你使用的是普通用户账户,请在命令前面使用 Run as Administrator 运行 PowerShell;
在网络方面,TLS 1.2 协议需可用,某些企业环境可能需要配置代理或镜像源,确保 Scoop 能正确下载清单和软件包;
预置条件与工具
需要准备的工具包括一个可执行的 PowerShell 环境以及一个能执行脚本的策略,通常设置为 RemoteSigned 以确保来自互联网的脚本可以执行;
下面的前置命令演示了如何开启执行策略并安装 Scoop 的安装脚本,确保你在具备管理员权限的 PowerShell 窗口中执行:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
iwr -useb https://get.scoop.sh | iex
安装 Scoop 与初始配置
安装 Scoop 的命令
通过上述步骤安装完成后,你将得到 Scoop 命令行工具,接下来需要用它来安装并管理 Windows 下的软件包;首次打开 PowerShell 时可能需要重新启动会话,以确保环境变量生效;
为了确保脚本来源可信,请在命令行中执行 iwr 拉取脚本的过程,并用 iex 执行,确保命令执行过程中的网络请求能够成功完成;
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
iwr -useb https://get.scoop.sh | iex
添加 Bucket 与环境变量
Scoop 通过“桶”(bucket)来组织不同的清单,默认主桶 main 已包含大量常用软件;若需要额外的软件版本信息,可以添加 versions 等桶以扩展可用清单;

完成桶添加后,Scoop 会自动将程序路径添加到系统 PATH,从而在任意命令行窗口直接访问安装的软件;
scoop bucket add main
scoop bucket add versions
使用 Scoop 安装 PHP
基本安装与版本检测
进入 Windows 环境后,最直接的方式是使用 scoop install php 安装最新版 PHP;若需要查看可用版本,可以先执行 scoop search php,了解有哪些版本可选;
安装完成后,Scoop 会自动将 PHP 的执行路径加入到系统 PATH,确保新路径在当前会话中生效,可以通过重新打开命令行窗口来确保生效;
scoop install php
scoop search php
环境验证与版本控制
完成安装后,快速验证 PHP 是否正常工作:执行 php -v 查看版本信息,以及 php -m 查看已加载的模块;如果看到版本信息和模块列表,说明安装正确;
如果需要指定某一具体版本,可结合 scoop search php 获取可用版本清单,然后用相应的清单名称安装;
php -v
php -m# 示例:安装特定版本(如 PHP 8.x 对应的清单名)
# scoop install php@8.0
快速测试示例与本地开发准备
在进行本地开发前,可以用 PHP 自带的简易服务器测试 Web 目录,快速启动本地站点,示例命令如下,使用内置服务器监听本地 8000 端口;
若你已经准备好一个公开目录 www,那么可以直接将其作为根目录进行测试;
php -S 127.0.0.1:8000 -t www
常见场景与快速示例
本地开发的小型站点搭建
在 Windows 上通过 Scoop 安装 PHP 后,使用内置服务器快速部署小型站点是最省时的方案;你可以在站点根目录放置 index.php,示例代码简单、易于调试;
以下是一段简单的 PHP 代码示例,便于你验证环境是否正常工作,直接粘贴到 index.php 即可运行:
与第三方服务的对接要点
如果你在本地开发时需要与数据库、缓存或队列等服务对接,确保 PHP 运行时的扩展已开启,如 mysqli、pdo_mysql 等模块;在 Windows 上,扩展在 PHP 配置中可通过启用相应的 dll 或在 php.ini 里添加扩展行来完成;
另外,结合本地开发服务器时,请确保端口未被占用,避免启动失败或端口冲突;
更新与维护
更新 Scoop 与 PHP
为了获得最新的安全补丁和功能改进,需要定期运行 scoop update 与 scoop update php,以确保 Scoop 自身和 PHP 版本保持最新;
在更新过程结束后,重新打开命令行会话,以确保新的 PATH 设置生效;
scoop update
scoop update php
常见问题排查
若遇到 PHP 命令不可用或找不到 php 的问题,通常是 PATH 未刷新或安装失败导致,请在新的命令行窗口中再次执行 php -v 进行验证;若仍有问题,检查 Scoop 环境变量 是否正确载入、网络是否可用以及镜像源是否受限;
在遇到权限相关错误时,确保以管理员身份重新打开 PowerShell,避免在受限账户中运行关键安装命令,以确保写入系统目录和注册表项的权限;


