# hprose-pecl

**Repository Path**: andot/hprose-pecl

## Basic Information

- **Project Name**: hprose-pecl
- **Description**: Hprose 全名是高性能远程对象服务引擎。它是一个新型的轻量级跨语言跨平台面向对象的高性能远程动态通讯中间件。它不但易学易用，而且功能强大。本项目是 Hprose 的PHP的 C 扩展版本实现。
- **Primary Language**: C
- **License**: MIT
- **Default Branch**: master
- **Homepage**: http://hprose.com
- **GVP Project**: No

## Statistics

- **Stars**: 11
- **Forks**: 2
- **Created**: 2014-08-02
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: rpc

**Tags**: None

## README

# Hprose extension for PHP

[![Join the chat at https://gitter.im/hprose/hprose-pecl](https://img.shields.io/badge/GITTER-join%20chat-green.svg)](https://gitter.im/hprose/hprose-pecl?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Build Status](https://travis-ci.org/hprose/hprose-pecl.svg)](https://travis-ci.org/hprose/hprose-pecl)
![Supported PHP versions: 5.2 .. 7.0](https://img.shields.io/badge/php-5.2~7.0-blue.svg)
[![GitHub release](https://img.shields.io/github/release/hprose/hprose-pecl.svg)](https://github.com/hprose/hprose-pecl/releases)
[![License](https://img.shields.io/github/license/hprose/hprose-pecl.svg)](http://opensource.org/licenses/MIT)

## Introduction

*Hprose* is a High Performance Remote Object Service Engine.

It is a modern, lightweight, cross-language, cross-platform, object-oriented, high performance, remote dynamic communication middleware. It is not only easy to use, but powerful. You just need a little time to learn, then you can use it to easily construct cross language cross platform distributed application system.

*Hprose* supports many programming languages, for example:

* AAuto Quicker
* ActionScript
* ASP
* C++
* Dart
* Delphi/Free Pascal
* dotNET(C#, Visual Basic...)
* Golang
* Java
* JavaScript
* Node.js
* Objective-C
* Perl
* PHP
* Python
* Ruby
* ...

Through *Hprose*, You can conveniently and efficiently intercommunicate between those programming languages.

This project is the implementation of Hprose extension for PHP.

## Installation

There are many ways to build the package. Below you can find details for most
useful ways of package building:

-----------------------------------------------------------------------------
### Way 1: Building the package with PHP

1.  Create ext/hprose folder in the php-source-folder. Copy all files
    from the package into created folder.

2.  Run

        ./buildconf

    to rebuild PHP's configure script.

3.  Compile php with option:

    `--enable-hprose` to build bundled into PHP module

    `--enable-hprose=shared` to build dinamycally loadable module

-----------------------------------------------------------------------------
### Way 2: Building the package with phpize utility

1.  Unpack contents of the package.

2.  Run

        phpize

    script, which will prepare environment for building hprose package.

3.  Run

        ./configure --enable-hprose=shared

    to generate makefile.

4.  Run

        make

    to build hprose extension library. It will be placed into
    ./modules folder.

5.  Run

        make install

    to install hprose extension library into PHP

-----------------------------------------------------------------------------
### Way 3: Install via pecl

1. Run:

        pecl install hprose

    That's all.

-----------------------------------------------------------------------------

## Usage

This extension is a part of [Hprose for PHP](http://github.com/hprose/hprose-php), It only implements hprose serialize, unserialize and RPC protocol abstraction layer. The real http client and server implementation are written in PHP. If you want to know how to use it, look at here:

http://github.com/hprose/hprose-php