Google App Engine Flex下CodeIgniter PHP应用mkdir()权限拒绝问题解决
GAE Flex环境下CodeIgniter mkdir权限报错解决方案
核心原因
GAE Flex的PHP运行时默认将代码部署目录/app设置为只读挂载,PHP进程以www-data用户身份运行,直接在应用代码目录下执行mkdir、文件写入操作必然触发权限拒绝错误。
分步配置方案
1. 选择适配需求的可写存储路径
根据上传文件的存储需求选对应的可写路径,禁止直接写入只读的/app非挂载子目录:
- 临时缓存、一次性临时文件:用系统默认可读写的
/tmp目录,无需额外配置挂载 - 需持久化的用户上传文件:直接挂载Cloud Storage桶为实例目录,保证多实例访问一致、数据不随实例重启丢失
2. 配置app.yaml挂载规则
根据存储需求修改应用根目录下的app.yaml配置:
- 若用临时tmpfs目录(适合仅实例本地的临时文件):
volumes: - name: local-tmp-upload volumeType: tmpfs mountPath: /var/app/uploads properties: sizeGb: 1
- 若用持久化Cloud Storage桶(适合用户上传文件):
volumes: - name: persistent-upload volumeType: gcsfs mountPath: /app/uploads properties: bucket-name: 你的GAE项目关联的可写存储桶名
注意:持久化存储需提前给App Engine默认服务账号分配该存储桶的
对象创建/写入权限,否则会触发云存储侧的权限拒绝。
3. 启动时自动修正目录权限
挂载完成后,默认目录可能没有分配给www-data用户写入权限,需在app.yaml的启动命令中加入初始化操作,避免权限不足:
# 示例为Apache运行时的启动命令,Nginx+PHP-FPM运行时对应替换为php-fpm启动命令即可 entrypoint: "mkdir -p /app/uploads && chown www-data:www-data /app/uploads && chmod 755 /app/uploads && apache2-foreground"
4. 修改CodeIgniter的路径配置
将CodeIgniter中所有需要写入的路径(上传目录、缓存目录、日志目录等)指向已配置的可写目录:
- 打开
application/config/config.php,修改对应配置项,比如上传路径:
// 若用/app下挂载的持久化目录 $config['upload_path'] = '/app/uploads'; // 若用/var/app下的tmpfs临时目录 // $config['upload_path'] = '/var/app/uploads';
- 执行mkdir操作时必须开启递归参数,避免父目录不存在报错:
mkdir($target_sub_dir, 0755, true);
常见坑规避
- 不要在未配置挂载的
/app代码子目录下手动修改权限并写入文件,每次部署更新后只读属性会覆盖手动配置 - 不要依赖实例本地的tmpfs/tmp目录存储用户上传文件,实例重启、扩容、缩容后本地文件会被清空,多实例间也无法共享本地文件
- 不要为了快速解决问题将PHP进程切换为root用户运行,会破坏运行时安全隔离规则,反而触发更多权限校验问题
内容的提问来源于stack exchange,提问作者MMuzammilQ
相关产品推荐
相关产品推荐

