PHP-Timecop 技术文档

1. 安装指南

使用包管理器安装

• macOS：如果你使用 macOS，可以通过 Homebrew 安装 php-timecop。

  brew install homebrew/php/php71-timecop
  

• Fedora：在 Fedora 上，你可以从官方仓库安装 php-timecop，作为 php-pecl-timecop。

  sudo dnf install php-pecl-timecop
  

• RHEL/CentOS：在 RHEL/CentOS 上，你可以从 Remi 的 RPM 仓库安装 php-timecop。

  sudo yum install http://rpms.famillecollet.com/enterprise/remi-release-7.rpm
  sudo yum install yum-utils
  sudo yum-config-manager --enable remi-php71
  sudo yum install php-pecl-timecop
  

• 其他：否则，你可以使用 pecl 命令安装 php-timecop。

  pecl install timecop-beta
  

使用 phpize 安装

git clone https://github.com/hnw/php-timecop.git
cd php-timecop
phpize
./configure
make
make install

安装后，将这些行添加到你的 php.ini 文件中。

extension=timecop.so

在 Windows 上安装（实验性）

你可以从 PECL :: Package :: timecop 下载扩展 DLL。安装扩展时，解压 zip 文件并将 php_timecop.dll 复制到扩展目录。安装后，将这些行添加到你的 php.ini 文件中。

extension=php_timecop.dll

2. 项目使用说明

PHP-Timecop 是一个 PHP 扩展，提供了“时光旅行”和“时间冻结”的功能。以下是基本的使用方法：

<?php
var_dump(date("Y-m-d")); // 输出当前日期
timecop_freeze(0); // 冻结时间到 1970-01-01 00:00:00
var_dump(gmdate("Y-m-d H:i:s")); // 输出冻结后的时间
var_dump(strtotime("+100000 sec")); // 输出计算后的时间戳

3. 项目API使用文档

时间冻结

使用 timecop_freeze() 函数来冻结时间到一个特定的点。

timecop_freeze($timestamp);

时光旅行

使用 timecop_travel() 函数来回溯到过去的一个特定时间点。

timecop_travel($timestamp);

时间缩放

使用 timecop_scale() 函数来加速时间的流逝。

timecop_scale($scaling_factor);

更多详细的使用方法和示例，请参考项目仓库中的 README.md 文件。

4. 项目安装方式

项目可以通过多种方式安装：

• 使用包管理器：适用于 macOS、Fedora 和 RHEL/CentOS。
• 使用 phpize：适用于 Linux 和 macOS，需要编译环境。
• 在 Windows 上安装：实验性支持，需要下载 DLL 文件。

请根据你的操作系统和需求选择合适的安装方式。