在 localhost 上安装 Magento
Magento 开源电商平台本地安装，通过 http://localhost/magento 开发与调试网店主题与模块。
Magento Open Source（原 Magento CE）是功能完整的 PHP 电商平台，适合 B2C/B2B 网店。本地安装资源占用较高，建议分配足够内存与使用 Composer。
前置条件
- PHP 8.1+ 或 8.2（以官方兼容矩阵为准）
- MySQL 8.0+ 或 MariaDB
- Elasticsearch 或 OpenSearch（Magento 2.4+ 搜索依赖）
- Composer 2
- 建议 RAM ≥ 8GB（本地全栈）
安装步骤（Composer）
composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition magento需 Magento Marketplace 的 auth.json 密钥。
- 配置 Web 服务器，DocumentRoot 指向
pub/（非项目根目录） - 或开发时将
magento放入htdocs/并配置别名指向pub/ - phpMyAdmin 创建数据库
magento_local - 命令行安装或浏览器访问 http://localhost/magento 运行 Setup Wizard
数据库示例
| 项 | 值 |
|---|---|
| 主机 | localhost |
| 数据库 | magento_local |
| 用户 | root |
常用路径
| 路径 | 说明 |
|---|---|
/（pub 根） | 商店前台 |
/admin | 管理后台 |
bin/magento | CLI（缓存、编译、部署） |
本地开发命令
php bin/magento setup:upgrade
php bin/magento cache:flush
php bin/magento indexer:reindex开发者模式：php bin/magento deploy:mode:set developer
常见问题
安装慢 / 内存不足
提高 PHP memory_limit（如 2G）；增加 swap；使用 COMPOSER_MEMORY_LIMIT=-1。
Elasticsearch 未运行
Magento 2.4+ 本地需安装 Elasticsearch/OpenSearch 或查阅官方 Docker 方案。
静态内容 404
运行 setup:static-content:deploy；开发模式可 symlink 静态文件。
小结
Magento 本地典型地址 **http://localhost/magento**（Web 根应对准 pub/），资源需求高，适合电商主题与模块专业开发。