freeshop/README.md

自由云商城

✿ 开源 ✿ PHP ✿ 免费 ✿ 轻量

自由云商城是自由云科技团队旗下的公益电商，坚持「公益 · 实惠 · 用心挑选」的理念，为社区提供周边、数码、虚拟服务与图书等好物。

如今，我们把这套商城系统完整开源，不仅是献给每一位需要轻量级电商解决方案的开发者、站长与公益组织，更是让大家找出这套商城系统的漏洞，协助我们的开发。

为什么开源？

自由云科技团队始终秉持「技术公益、共建共享」的初心。自由云商城从诞生之初就服务于公益项目与社区用户，经过数个版本的迭代，已经足够稳定、灵活、易用。我们相信，一套干净、轻量、无冗余功能的商城系统，不应该只被一个团队使用。

开源，是为了让更多有需要的人：

• 免去重复造轮子：无需从零开发一套商城，直接基于自由云商城二次开发或功能裁剪；
• 自由部署与使用：不受商业授权限制，可用于个人项目、公益组织、非营利社区、教育场景；
• 共同参与改进：任何人都可以提交工单、建议或代码，让这套系统越来越好。

系统特点

• 轻量纯净：核心代码精简，无冗余依赖，适合低配置服务器（1C1G 即可流畅运行）；
• 公益友好：内置公益模式开关，一键关闭价格显示、购物车结算，仅展示商品信息，适合公益展示型站点；
• 商品体系灵活：支持实物商品与虚拟商品混合管理；
• 订单管理简洁：后台订单列表清晰可查，支持状态筛选与批量操作，无需复杂 ERP 即可完成日常处理；
• 国际化：内置多语言架构，支持前台界面一键切换语言，方便不同语种用户访问。

适用场景

• 公益组织/非营利机构的物资展示与发放平台；
• 校园社团的小型周边售卖；
• 个人创作者的作品展示与简单交易；
• 社区/论坛配套的积分兑换商城；
• 任何想快速拥有电商功能的轻量级项目。

技术架构

项目	说明
后端语言	PHP
数据库	MySQL / MariaDB / SQLite
前端框架	原生 HTML + CSS + JavaScript
会话管理	原生 PHP Session + Cookie
安全机制	CSRF 防护、SQL 预处理、XSS 过滤、输入校验
支付集成	支持支付宝/微信支付（可配置），公益模式可完全关闭支付功能
部署方式	支持源码直接部署，兼容主流虚拟主机与云服务器

获取与使用

安装方式：

1. 下载源码包并解压至网站根目录；
2. 访问 install.php，按指引完成数据库配置与管理员账号创建；
3. 登录后台进行基础设置（站点名称、积分设置、支付参数等）；
4. 添加商品，即可正式运行。

环境要求：

• PHP 7.4 及以上版本
• MySQL / MariaDB / SQLite
• 服务器需支持 URL 重写（Apache mod_rewrite / Nginx 伪静态）
• PHP 扩展：PDO、GD、CURL、JSON、Session

参与贡献

我们欢迎所有形式的贡献，包括但不限于：

• 在工单中报告 BUG 或提出改进建议；
• 在合并请求中提交代码修复或功能增强；
• 在自己的项目中部署使用，并分享反馈。

写在最后

自由云商城是自由云科技团队「为人民服务」理念的延伸。希望这套小小的系统，能帮助到更多想做点事情的人。

少一些商业套路，多一些实在功能。用起来，改起来，分享出去。

这就是我们开源它的全部理由。