HadooPHP 技术文档

1. 安装指南

环境要求

• 需要一个正常运行的Hadoop集群，包括namenode、jobtracker和其他组件。
• 如果是在本地开发，请按照Hadoop快速入门指南设置伪分布式模式。
• 必须启用PHAR PHP扩展，并且在php.ini中将phar.readonly设置为0，以便能够编译作业。

安装步骤

1. 确保Hadoop集群正常运行。
2. 安装PHP并启用PHAR扩展。
3. 下载HadooPHP框架代码。
4. 配置环境变量$HADOOP_HOME，指向Hadoop的安装目录。

2. 项目的使用说明

创建作业

1. 创建一个文件夹，文件夹名称将作为作业名称。
2. 在文件夹中创建Mapper.php文件，包含Mapper类。
3. 如果需要，创建Reducer.php文件，包含Reducer类。
4. 如果需要自定义参数，可以创建一个ARGUMENTS文件，文件中每行必须以反斜杠结尾。

编译作业

假设作业名称为"TpsReportCount"，运行以下命令进行编译：

bin/compile.sh TpsReportCount <BUILDDIR>

• 注意：构建目录必须存在且可写。
• 可以通过compile.sh传递路径名称和默认时区参数，不带参数运行以获取使用帮助。

运行作业

假设作业名称为"TpsReportCount"，运行以下命令：

path/to/builddir/TpsReportCount.sh <HDFSINPUTPATH...> <HDFSOUTPUTPATH>

• 可以传递任意数量的输入路径名称，最后一个路径名称是输出路径。
• 也可以传递Hadoop配置目录路径：

path/to/builddir/TpsReportCount.sh -c path/to/dir/with/remote-cluster-config <HDFSINPUTPATH...> <HDFSOUTPUTPATH>

3. 项目API使用文档

Mapper类

• Mapper.php文件中定义的类，负责处理输入数据并生成中间键值对。

Reducer类

• Reducer.php文件中定义的类，负责处理中间键值对并生成最终输出。

ARGUMENTS文件

• 自定义参数文件，每行必须以反斜杠结尾。
• 包含-mapper和-reducer命令，以及其他自定义参数。

4. 项目安装方式

下载项目

从GitHub下载HadooPHP框架代码。

配置环境

1. 设置$HADOOP_HOME环境变量。
2. 确保PHP的PHAR扩展已启用。

编译和运行

按照上述步骤创建、编译和运行作业。

---

通过以上文档，您应该能够顺利安装、使用和理解HadooPHP框架。如有任何问题，请参考项目README和GitHub Wiki获取更多信息。