为集成Apple FileMaker Server的老旧CakePHP网站添加SSL证书及升级问询

是否必须重写网站才能完成版本升级？ #

不是必须完全重写。CakePHP从1.2.6到最新版本虽然跨了多个大版本，但可以通过分步升级的方式逐步适配，无需一次性重写整个网站：

• 第一步升级到CakePHP 1.3：这一步变更最小，主要是弃用部分旧函数、调整命名规范，官方有明确的迁移指南，只需针对性修改代码，无需重构业务逻辑。
• 第二步从1.3升级到2.x：需要调整目录结构（比如app/下的文件布局）、适配PHP 5.3+的语法，替换set()、redirect()等弃用方法，可按模块逐步调整。
• 第三步从2.x升级到3.x/4.x/5.x：这一步涉及命名空间全面引入、ORM重构，需要将旧模型替换为Table类，查询逻辑从数组改为QueryBuilder，但仍可分模块迁移，保留原有业务逻辑。

完全重写是可选方案，但分步升级能大幅减少工作量，适合希望保留现有业务逻辑的场景。

添加SSL证书的步骤与注意事项 #

操作步骤 #

1. 获取SSL证书：从可信CA机构（如Let's Encrypt、DigiCert）获取证书文件（.crt）、私钥（.key）及中间证书（若有）。
2. 配置Web服务器：
   • Apache：启用mod_ssl模块，修改虚拟主机配置：

     <VirtualHost *:443>
         ServerName yourdomain.com
         DocumentRoot /path/to/your/cake/app/webroot
         SSLEngine On
         SSLCertificateFile /path/to/certificate.crt
         SSLCertificateKeyFile /path/to/private.key
         SSLCertificateChainFile /path/to/chain.crt
         # 保留原有业务配置
     </VirtualHost>
     
     <VirtualHost *:80>
         ServerName yourdomain.com
         Redirect permanent / https://yourdomain.com/
     </VirtualHost>
     

   • Nginx：配置HTTPS监听及HTTP跳转：

     server {
         listen 80;
         server_name yourdomain.com;
         return 301 https://$server_name$request_uri;
     }
     
     server {
         listen 443 ssl;
         server_name yourdomain.com;
         root /path/to/your/cake/app/webroot;
     
         ssl_certificate /path/to/certificate.crt;
         ssl_certificate_key /path/to/private.key;
         ssl_protocols TLSv1.2 TLSv1.3;
         ssl_ciphers HIGH:!aNULL:!MD5;
         # 保留原有业务配置
     }
     

3. 调整CakePHP配置：修改app/config/core.php，设置HTTPS的基础URL：

   Configure::write('App.fullBaseUrl', 'https://yourdomain.com');
   

4. 清理硬编码链接：将网站内手动编写的HTTP链接替换为HTTPS，或使用框架的HtmlHelper::link()等方法自动生成链接。

注意事项 #

• 禁用SSLv3、TLSv1.0等不安全协议，仅保留TLS 1.2及以上版本。
• 检查是否存在混合内容问题（浏览器控制台会提示HTTP资源加载错误），确保所有静态资源（图片、脚本、样式）均使用HTTPS。
• 若网站连接FileMaker Server使用HTTP，需同步将FileMaker连接改为HTTPS，避免混合内容报错。
• 定期更新SSL证书，避免过期导致网站无法访问。

CakePHP与FileMaker集成的步骤与注意事项 #

现有1.2版本适配SSL的调整 #

1. 修改FileMaker连接代码：将原有HTTP连接地址改为HTTPS，若使用旧版FileMaker PHP API，可配置SSL验证：

   require_once('/path/to/FileMaker.php');
   $fm = new FileMaker(
       'your_database_name',
       'https://your-fms-server.com',
       'username',
       'password'
   );
   // 测试环境可临时跳过证书验证（生产环境不推荐）
   $fm->setProperty('curlOptions', array(CURLOPT_SSL_VERIFYPEER => false));
   

2. 配置FileMaker Server SSL：在FileMaker Server管理控制台启用SSL，导入可信证书，确保对应端口（默认443或FileMaker专用端口）在防火墙中开放。

升级CakePHP版本后的集成适配 #

1. 替换集成方式：旧版FileMaker PHP API不兼容PHP 7+，需改用官方的FileMaker Data API，通过REST请求实现集成：
   示例（CakePHP 4.x）：

   use Cake\Http\Client;
   
   $http = new Client();
   // 获取认证令牌
   $authResponse = $http->post(
       'https://your-fms-server.com/fmi/data/vLatest/databases/your_db/sessions',
       ['username' => 'user', 'password' => 'pass'],
       ['type' => 'json']
   );
   $token = $authResponse->json['response']['token'];
   
   // 查询记录
   $queryResponse = $http->get(
       'https://your-fms-server.com/fmi/data/vLatest/databases/your_db/layouts/your_layout/records',
       [],
       ['headers' => ['Authorization' => 'Bearer ' . $token]]
   );
   $records = $queryResponse->json['response']['data'];
   

2. 关键注意事项：
   • 在FileMaker Server中启用Data API，并为用户分配API访问权限。
   • 缓存认证令牌，避免每次请求重复获取，同时处理令牌过期逻辑。
   • 适配高版本CakePHP的命名空间和HTTP客户端用法，重构原有集成代码。

内容的提问来源于stack exchange，提问作者Conrado Conchitoro