讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Seko
Seko

AI短剧一键生成成片

Laper
Laper

剧本策划到成片协作

composer怎么在Win11运行_composer怎么解决系统兼容问题【指南】

轻枫同学_8880

轻枫同学_8880

发布时间:2026-03-16 16:41:01

|

866人浏览过

|

来源于php中文网

原创

Composer在Win11报“不是有效的 Win32 应用程序”是因PHP或Composer架构不匹配,需确认php -r "echo PHP_INT_SIZE*8;"输出64,下载VC17 x64 Thread Safe版PHP并用官方脚本安装Composer。

composer怎么在win11运行_composer怎么解决系统兼容问题【指南】

Composer 在 Win11 上打不开或报错“不是有效的 Win32 应用程序”

这是 32 位 PHP 或 Composer 可执行文件在 64 位 Win11 系统上运行失败的典型表现,本质是架构不匹配。Win11 已彻底移除对 16 位/旧版 32 位子系统的支持,哪怕系统能运行大部分 32 位程序,PHP 的 CLI 模块若编译自老旧工具链(如 VC14、VC15),仍可能触发此错误。

  • 确认 PHP 架构:php -v 后立即运行 php -r "echo PHP_INT_SIZE * 8;",输出 64 才安全;输出 32 就必须换包
  • 从 windows.php.net 下载标有 Thread Safe (x64) 和 VC17(对应 VS2022)的 ZIP 包,解压后替换整个 PHP 目录
  • Composer 安装必须用官方推荐方式:用 php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" + php composer-setup.php,不要下载 composer.phar 后手动改后缀为 .exe
  • 避免使用 Chocolatey 或 Scoop 安装的 composer,它们常捆绑过时 PHP 运行时,与你本地 PHP 冲突

Win11 启用 WSL2 后,composer install 卡住或超时

WSL2 默认使用虚拟网络,DNS 解析和 HTTPS 请求容易被 Win11 主机防火墙或企业代理拦截,尤其在首次运行或更新包时卡在 Loading composer repositories with package information。

  • 临时绕过 DNS 问题:在 WSL2 中执行 echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf(注意加 sudo,且每次重启 WSL2 会重置)
  • 强制走 IPv4(避免 IPv6 超时):composer config -g repo.packagist.org.url https://packagist.org,再加 composer config -g github-protocols https
  • 若公司网络有代理,别只设 HTTP_PROXY,必须同步设置 HTTPS_PROXY 和 NO_PROXY=127.0.0.1,localhost
  • 禁用 WSL2 的 systemd(它常干扰 Composer 的进程等待逻辑):在 /etc/wsl.conf 中写入 [boot] systemd=false,然后 wsl --shutdown 重启

composer create-project 在 Win11 报错 “symlink(): Operation not permitted”

Win11 默认关闭 NTFS 符号链接权限,而 Composer 在创建项目时默认尝试用 symlink 复制 vendor 包(尤其 Laravel 等框架模板),导致失败。这不是 bug,是 Windows 安全策略收紧后的正常行为。

CircleCI Orb Composer
CircleCI Orb Composer

使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。

下载
  • 以管理员身份打开 PowerShell,运行:Set-ExecutionPolicy RemoteSigned -Scope CurrentUser,再执行:Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux -NoRestart(确保 WSL 已启用)
  • 更直接有效的方式:在项目目录下先执行 composer config --global use-symlinks false,让 Composer 改用 copy 替代 symlink
  • 若仍需符号链接(比如开发 WordPress 插件),需在 Win11 设置 → 隐私和安全性 → 开发人员选项 → 启用“开发者模式”,再以管理员运行 CMD 执行:fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1
  • 注意:Git Bash 或 Cygwin 下的 composer 不受此限,但它们的 PHP 运行时往往版本陈旧,不建议混用

Win11 自带的 Windows Terminal 中运行 composer update 显示乱码或中文路径出错

根本原因是 Windows Terminal 默认编码为 UTF-8,而 Composer(尤其是老版本)内部仍依赖系统 ANSI 代码页(如 CP936),读取含中文的 composer.json 或路径时解析失败,表现为 JSON 解析错误、找不到包、或控制台输出方块乱码。

  • 在终端中先执行:chcp 65001(切换到 UTF-8),再运行 composer update —— 该命令需每次新开终端后手动执行
  • 永久生效:右键 Windows Terminal 标题栏 → 设置 → 启动 → 默认配置 → 命令行,改为:powershell.exe -Command "chcp 65001 | Out-Null; $env:COMPOSER_HOME='C:\Users\%USERNAME%\.composer'; powershell"
  • 检查 composer.json 文件本身是否为 UTF-8 无 BOM 编码(用 VS Code 打开右下角确认,不是 UTF-8 with BOM)
  • 避免在路径含中文的目录中初始化项目,比如 C:\用户\张三\project,Win11 的路径 API 兼容性仍不稳定,优先用英文路径如 C:\dev\myapp

Win11 对符号链接、编码、网络栈的改动都是渐进式收紧的,没有一劳永逸的开关。最稳的做法是:用原生 WSL2 + Ubuntu + 官方 PHP 二进制 + Composer 官方安装脚本,绕开 Windows 层所有兼容层。如果非得在 cmd/PowerShell 里跑,就老老实实关掉 symlink、切对代码页、用对 PHP 架构——少一个环节,第二天就可能突然挂掉。

热门AI工具

更多
PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

897

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

875

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2528

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

5181

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

7670

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

5016

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

9429

2025.08.05

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

1536

2026.03.04

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpMyAdmin 安装文档
phpMyAdmin 安装文档

共0课时 | 0人学习

phpEnv手册
phpEnv手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn