导入并信任 GitHub Web Flow GPG 密钥 (noreply@github.com) 作者: Shine 时间: 2025-05-15 分类: 神奇技巧 评论 本指南介绍如何导入 GitHub Web Flow GPG 密钥，并手动将其信任等级设置为完全信任（ultimate），因为导入后的默认信任等级为未知。 ## 步骤 1：导入 GPG 密钥 使用以下命令导入 GitHub Web Flow GPG 密钥： ```bash curl https://github.com/web-flow.gpg | gpg --import ``` 该命令从 GitHub 下载 GPG 密钥并将其导入到您的 GPG 密钥环中。 ## 步骤 2：验证导入的密钥 导入后，您可以通过列出所有 GPG 密钥来验证密钥是否已成功添加： ```bash gpg --list-keys ``` 输出： > 其中有一个是过期的密钥，原因请参考： > * https://github.blog/news-insights/company-news/rotating-credentials-for-github-com-and-new-ghes-patches/ > * https://github.com/orgs/community/discussions/122178 ```bash pub rsa2048 2017-08-16 [SC] [过期于：2024-01-16] 5DE3E0509C47EA3CF04A42D34AEE18F83AFDEB23 uid [ 过期 ] GitHub (web-flow commit signing) <noreply@github.com> pub rsa4096 2024-01-16 [SC] 968479A1AFF927E37D1A566BB5690EEEBB952194 uid [ 未知 ] GitHub <noreply@github.com> ``` 查找与 `web-flow` 相关或 GitHub 提供的密钥 ID。输出将包含密钥的指纹和用户 ID 等详细信息，这里 KEY ID 是 `968479A1AFF927E37D1A566BB5690EEEBB952194` ## 步骤 3：将信任等级设置为完全信任 默认情况下，导入的密钥信任等级为未知，可能会在验证签名时出现问题。要将信任等级设置为完全信任，请按照以下步骤操作： 1. 启动 GPG 密钥编辑，针对特定的密钥。用实际的 GitHub Web Flow 密钥 ID 或指纹替换 `KEY_ID`： ```bash gpg --edit-key KEY_ID # gpg --edit -key 968479A1AFF927E37D1A566BB5690EEEBB952194 ``` 2. 在 GPG 提示符下，输入 `trust` 以修改信任设置： ``` gpg> trust ``` 3. 选择选项 `5` 表示完全信任： ``` 请决定您对该用户正确验证其他用户密钥的信任程度 （通过查看护照、检查不同来源的指纹等） 1 = 我不知道或不发表意见 2 = 我不信任 3 = 我略微信任 4 = 我完全信任 5 = 我绝对信任 m = 返回主菜单 您的决定？ 5 ``` 4. 确认您的选择： ``` 您真的想将此密钥设置为绝对信任吗？(y/N) y ``` 5. 保存更改并退出： ``` gpg> quit ``` 示例截图：  ## 步骤 4：验证信任等级 要确认信任等级已更新，再次列出密钥详情： ```bash gpg --list-keys ``` 输出应显示该密钥现已被设置为绝对信任。 ## 注意事项 - 请将 `KEY_ID` 替换为实际的 GitHub Web Flow 密钥 ID 或指纹，您可以在 `gpg --list-keys` 的输出中找到。 - 将密钥设置为绝对信任表示您完全信任其用于验证签名的能力。在操作前，请确保您对密钥的真实性有信心。 - 有关 GPG 密钥管理的更多信息，请参阅官方 GPG 文档或 GitHub 关于验证签名的文档。 相关参考链接： 1. https://gnupg.org/howtos/zh/GPGMiniHowto-3.html 2. https://github.blog/news-insights/company-news/rotating-credentials-for-github-com-and-new-ghes-patches/
理解 Composer 的环境变量 COMPOSER_IGNORE_PLATFORM_REQ 和 COMPOSER_IGNORE_PLATFORM_REQS 作者: Shine 时间: 2025-05-15 分类: PHP 评论 在 PHP 项目开发中，[Composer](https://getcomposer.org/) 是管理依赖的核心工具。它通过检查 PHP 环境（如版本和扩展）确保依赖兼容性。但有时我们需要在不符合平台要求的条件下安装依赖，这时环境变量 `COMPOSER_IGNORE_PLATFORM_REQ` 和 `COMPOSER_IGNORE_PLATFORM_REQS` 提供了解决方案。 ## 什么是 `COMPOSER_IGNORE_PLATFORM_REQ` 和 `COMPOSER_IGNORE_PLATFORM_REQS`？ 这两个环境变量用于绕过 Composor 的平台要求检查，平台要求包括： - PHP 版本（如 `php: ^7.4`） - PHP 扩展（如 `ext-curl`、`ext-json`） - 其他系统级依赖 当环境不满足依赖要求时，Composer 会报错并阻止安装。两者的区别在于： - **`COMPOSER_IGNORE_PLATFORM_REQ`**：允许指定忽略特定的平台要求（如 `ext-curl` 或 `php`）。 - **`COMPOSER_IGNORE_PLATFORM_REQS`**：忽略所有平台要求，等效于命令行选项 `--ignore-platform-reqs`。 ## 为什么需要忽略平台要求？ 常见场景包括： 1. **开发或测试**：本地或 CI/CD 环境的 PHP 版本或扩展与生产环境不同，但需安装依赖进行测试。 2. **临时绕过**：某些依赖在未满足官方要求的环境中仍可运行。 3. **遗留项目**：老项目依赖的包可能与新环境不完全兼容，但需继续维护。 ## 如何使用？ ### 使用 `COMPOSER_IGNORE_PLATFORM_REQ` 通过环境变量指定要忽略的特定平台要求： ```bash COMPOSER_IGNORE_PLATFORM_REQ=ext-curl composer install ``` 忽略多个要求时，用逗号分隔： ```bash COMPOSER_IGNORE_PLATFORM_REQ=ext-curl,ext-json composer update ``` ### 使用 `COMPOSER_IGNORE_PLATFORM_REQS` 若需忽略所有平台要求，设置此变量（无需指定具体要求）： ```bash COMPOSER_IGNORE_PLATFORM_REQS=1 composer install ``` 或者直接使用命令行选项： ```bash composer install --ignore-platform-reqs ``` ### 在类 Unix 平台持久化配置 在类 Unix 系统（如 Linux 或 macOS）中，可以将环境变量添加到 shell 配置文件（如 `.bashrc` 或 `.zshrc`）以持久化设置。步骤如下： 1. 打开终端，编辑配置文件（以 Zsh 为例）： ```bash nano ~/.zshrc ``` 对于 Bash，编辑 `.bashrc`： ```bash nano ~/.bashrc ``` 2. 在文件末尾添加以下行，例如忽略 `ext-curl`： ```bash export COMPOSER_IGNORE_PLATFORM_REQ=ext-curl ``` 或忽略所有要求： ```bash export COMPOSER_IGNORE_PLATFORM_REQS=1 ``` 多个特定要求： ```bash export COMPOSER_IGNORE_PLATFORM_REQ=ext-curl,ext-json ``` 3. 保存并刷新 shell 配置： ```bash source ~/.zshrc ``` 或： ```bash source ~/.bashrc ``` 4. 验证设置： ```bash echo $COMPOSER_IGNORE_PLATFORM_REQ echo $COMPOSER_IGNORE_PLATFORM_REQS ``` 此后，Composer 命令将自动应用这些设置。 ### Windows 用户 在 Windows 命令行中，临时设置语法为： ```cmd set COMPOSER_IGNORE_PLATFORM_REQ=ext-curl && composer install set COMPOSER_IGNORE_PLATFORM_REQS=1 && composer install ``` ## 潜在风险 使用这两个变量需注意： 1. **运行时错误**：忽略要求可能导致依赖在运行时因缺少扩展或版本不兼容而失败。 2. **生产环境谨慎**：建议仅在开发或测试中使用，生产环境应满足依赖要求。 3. **调试复杂**：绕过检查可能增加问题排查难度。 ## 最佳实践 - **选择合适的变量**：若只需忽略特定要求，使用 `COMPOSER_IGNORE_PLATFORM_REQ`；若需忽略全部，使用 `COMPOSER_IGNORE_PLATFORM_REQS`。 - **记录原因**：在项目文档中说明忽略平台要求的理由，便于团队理解。 - **充分测试**：忽略要求后，彻底测试应用以确保依赖正常运行。 ## 总结 `COMPOSER_IGNORE_PLATFORM_REQ` 和 `COMPOSER_IGNORE_PLATFORM_REQS` 是 Composer 的强大工具，分别用于忽略特定或全部平台要求检查。在类 Unix 系统中，通过配置 `.bashrc` 或 `.zshrc`，可以持久化这些设置，提升开发效率。但需谨慎使用，确保测试充分并避免在生产环境中引入风险。合理运用这些变量，能让 PHP 依赖管理更加灵活。
使用 MacPorts 替代 brew / 解决低版本 macOS 系统使用 brew 安装软件包慢的问题 作者: Shine 时间: 2025-05-13 分类: macOS 评论 ## 背景 根据官方的介绍，brew 仅适合 macOS 13 及更高的版本上使用了：https://docs.brew.sh/Installation#macos-requirements 对于我还在用黑苹果 macOS Big Sur 确实不友好（公司电脑 3、4 年都没更新硬件了 😓）  ## brew 替代品 - MacPorts 通过在网络搜索，很多人推荐使用 [MacPorts](https://macports.org/ "MacPorts") 替代 brew。 安装方法也很简单，下载一个安装包就可以用了，具体安装教程看这个：https://www.macports.org/install.php 以我的系统 Big Sur 为例，我就下载对应的版本安装就好了  ### 使用方法 使用方法也很简单，访问这个网站 https://ports.macports.org/ 搜索你要的软件，比如 PHP84  找到对应的版本，点击进入详情，然后就会提示你用什么命令安装，点击 Copy 返回到终端执行即可： | - | - | | ------------ | ------------ | |  |  | | |  | 网络环境好的情况下，安装速度挺快的
使用 Certimate 批量部署腾讯云 CDN 证书，解放双手 作者: Shine 时间: 2025-05-02 分类: DevOps 评论 ## Certimate 介绍 GitHub：https://github.com/usual2970/certimate 做个人产品或者在中小企业里负责运维的同学，会遇到要管理多个域名的情况，需要给域名申请证书。但是手动申请证书有以下缺点： - 😱 麻烦：申请证书并部署到服务的流程虽不复杂，但也挺麻烦的，犹其是你有多个域名需要维护的时候。 - 😭 易忘：另外当前免费证书的有效期只有 90 天，这就要求你定期的操作，增加了工作量的同时，你也很容易忘掉续期，从而导致网站访问不了。 Certimate 就是为了解决上述问题而产生的，它具有以下优势： - **本地部署**：一键安装，只需要下载二进制文件，然后直接运行即可。同时也支持 Docker 部署、源代码部署等方式。 - **数据安全**：由于是私有部署，所有数据均存储在自己的服务器上，不会经过第三方，确保数据的隐私和安全。 - **操作简单**：简单配置即可轻松申请 SSL 证书并部署到指定的目标上，在证书即将过期前自动续期，从申请证书到使用证书完全自动化，无需人工操作。 Certimate 旨在为用户提供一个安全、简便的 SSL 证书管理解决方案。 ## 我的痛点 现在免费 SSL 证书基本都是 3 个月有效期，然而我在腾讯云 CDN 部署了非常多的域名，导致每次证书更新都非常麻烦。 但是现在我可以借助 Certimate 可以很方便的管理和部署 SSL 证书到腾讯云 CDN！ 详细使用步骤建议查看 Certimate 官方文档进行操作，本片文章只是重点讲述“**使用 Certimate 批量部署腾讯云 CDN 证书**” ## 配置授权 1. 首先**新建授权**：  2. 腾讯云创建子账号，权限配置**权限策略**： - `QcloudSSLFullAccess` - `QcloudDNSPodFullAccess`（如果你的域名在腾讯云，则给予这个权限）  ## 配置 Certimate 工作流 1. 配置申请的证书，我这边申请的是 `*.nowtool.cn` 和 `nowtool.cn`  2. 按照如下图配置，特别说明：**腾讯云云产品地域**实测填写 `ap-guangzhou` 即可成功部署  ## 完成 去腾讯云控制台检查部署情况 