; REDCap PHP配置文件 ; 版本:v1.0 ; 日期:2026-01-01 ; 适用:开发/测试/生产环境 ; ========== 文件上传配置(REDCap必需) ========== ; REDCap允许上传临床试验文件、影像资料等 upload_max_filesize = 32M post_max_size = 32M max_file_uploads = 20 ; ========== 执行时间配置 ========== ; 数据导出和复杂查询需要更长时间 max_execution_time = 300 max_input_time = 300 default_socket_timeout = 60 ; ========== 内存限制 ========== ; REDCap推荐最低256MB memory_limit = 256M ; ========== 时区配置 ========== ; 非常重要!影响数据时间戳 date.timezone = Asia/Shanghai ; ========== 错误报告(开发环境) ========== ; 开发环境:显示所有错误 ; 临时关闭 display_errors 避免干扰压缩输出流(ERR_CONTENT_DECODING_FAILED) display_errors = Off display_startup_errors = Off error_reporting = E_ALL ; 生产环境应修改为: ; display_errors = Off ; display_startup_errors = Off ; error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT ; log_errors = On ; error_log = /var/log/php/error.log ; ========== Session配置 ========== ; REDCap使用Session管理用户登录状态 session.save_handler = files session.save_path = "/tmp" session.gc_maxlifetime = 3600 session.cookie_lifetime = 0 session.cookie_httponly = 1 session.cookie_secure = 0 ; 生产环境HTTPS启用时改为1 session.use_strict_mode = 1 session.use_cookies = 1 session.use_only_cookies = 1 ; ========== 安全配置 ========== ; 禁止危险函数(生产环境推荐) ; disable_functions = exec,passthru,shell_exec,system,proc_open,popen ; 允许URL文件访问(REDCap的Web Service功能需要) allow_url_fopen = On ; 禁止URL文件包含(安全) allow_url_include = Off ; 隐藏PHP版本信息(安全) expose_php = Off ; ========== 数据库配置 ========== ; MySQL连接超时 mysqli.default_socket = mysqli.connect_timeout = 60 mysqli.reconnect = On ; ========== OPcache配置(性能优化) ========== ; 生产环境强烈推荐启用OPcache opcache.enable = 1 opcache.enable_cli = 0 opcache.memory_consumption = 128 opcache.interned_strings_buffer = 8 opcache.max_accelerated_files = 10000 opcache.revalidate_freq = 2 opcache.fast_shutdown = 1 ; 开发环境可能需要禁用缓存验证 ; opcache.validate_timestamps = 0 ; ========== 字符编码 ========== ; 确保UTF-8编码(支持中文) default_charset = "UTF-8" mbstring.language = UTF-8 mbstring.internal_encoding = UTF-8 ; ========== 邮件配置 ========== ; SMTP配置(REDCap调查邀请等功能需要) ; 通常在REDCap控制中心配置,这里可留空 SMTP = localhost smtp_port = 25 sendmail_from = noreply@localhost ; ========== 输出缓冲 ========== ; REDCap数据导出需要 ; 临时禁用输出缓冲,解决 ERR_CONTENT_DECODING_FAILED output_buffering = Off ; ========== 禁用 zlib 压缩(解决 ERR_CONTENT_DECODING_FAILED)========== ; REDCap 内部会控制输出压缩,必须禁用 PHP 层面的压缩避免冲突 zlib.output_compression = Off zlib.output_compression_level = -1 zlib.output_handler = ; ========== 其他配置 ========== ; 最大输入变量数(复杂表单需要) max_input_vars = 3000 ; 最大输入嵌套层级 max_input_nesting_level = 64 ; 日志配置 log_errors = On log_errors_max_len = 1024 ; ========== 扩展配置 ========== ; 确保以下扩展已启用(在Dockerfile中已安装) ; extension=mysqli ; extension=pdo_mysql ; extension=gd ; extension=zip ; extension=soap ; extension=ldap ; extension=mbstring ; extension=calendar ; extension=bcmath ; ========== 注释说明 ========== ; 1. 此配置适用于REDCap 15.8.0 ; 2. 生产环境应关闭display_errors ; 3. 生产环境应启用OPcache ; 4. 文件上传大小可根据需求调整 ; 5. 时区配置必须正确,影响数据时间戳