PHP 확장 개발: 자체 수학 함수 라이브러리 개발-PHP 튜토리얼-php.cn

이 글의 내용은 PHP 확장 개발과 자체 수학 함수 라이브러리 개발을 공유하는 것입니다. 이는 특정 참조 가치가 있습니다. 도움이 필요한 친구는 이를 참조할 수 있습니다.

PHP 확장은 발전된 기술 중 하나입니다. PHP 프로그래머는 먼저, 초보 PHP 확장 개발자가 어떻게 성숙한 확장을 개발하고 PHP 개발의 고급 분야에 들어갈 수 있는지 이해해야 합니다. 이 개발 튜토리얼 시리즈는 초보 단계부터 고급 단계까지 단계별로 안내합니다.
이 튜토리얼 시리즈는 Linux(centos 권장)에서 개발되었으며, PHP 버전은 5.6이며, 귀하가 특정 Linux 운영 경험과 c/c++ 기초를 가지고 있다고 가정합니다.
질문이 있거나 소통이 필요한 경우 QQ 기술 교류 그룹 32550793에 가입하여 저와 소통하세요.

이전 장에서는 hello world 확장을 설명했습니다. 누구나 PHP-CPP로 개발된 확장 C++ 소스 코드의 기본 스타일에 대한 기본적인 이해를 갖고 있습니다. 다양한 인터페이스 함수를 내보내는 방법을 익히기 위해 간단한 수학 연산 라이브러리(mymath)를 개발해 보겠습니다.
mymath 수학 라이브러리의 코드는 github에 있습니다. git을 통해 직접 다운로드하거나 브라우저에서 웹페이지를 열어 소스 코드를 다운로드할 수 있습니다.

git 다운로드 명령줄

git clone https://github.com/elvisszhang/phpcpp_mymath.git

로그인 후 복사

브라우저 다운로드 URL은 웨어하우스 URL과 동일합니다: https://github.com/elvisszhan...

1 매개변수 없이 반환 값 없이 확장 함수를 작성하는 방법

함수 함수: 100 이내의 소수 출력

함수 이름: mm_print_pn_100

확장 함수 등록 방법

php에서 직접 호출할 수 있도록 get_module 함수 본문에 mm_print_pn_100 함수를 등록해야 합니다.

PHPCPP_EXPORT void *get_module() 
{
        // 必须是static类型，因为扩展对象需要在PHP进程内常驻内存
        static Php::Extension extension("mymath", "1.0.0");
        
        //这里可以添加你要暴露给PHP调用的函数
        extension.add<mm_print_pn_100>("mm_print_pn_100");
        
        // 返回扩展对象指针
        return extension;
}

로그인 후 복사

함수 선언 및 코드는 다음과 같습니다.
함수에는 매개변수가 필요하지 않으므로 함수의 매개변수 목록에 아무 것도 넣을 필요가 없으며 그냥 비워두세요. 함수는 값을 반환할 필요가 없으며 반환 값 유형은 void로 설정됩니다.

//打印100以内的素数
void mm_print_pn_100()
{
    int x = 2;
    int y = 1;
    int line = 0;
    while (x <= 100){
        int z = x - y; //z随y递减1
        int a = x%z; //取余数
        if (a == 0) { //如果x被z整除
            if (z == 1) {//如果z为1（x是质数）
                Php::out << x << " ";//输出x
                line ++;//每行输出的数的数量加1
             }
            x ++; //x加1
            y = 1;//y还原
        }
        else {//如果没有被整除
            y ++;//y加1，下一次循环中z减1
        }
        if (line == 10) {//每输出10个数 
            Php::out << std::endl;//输出一个换行        
            line = 0;//还原line
        }
    }
    if (line != 0) //最后一行输出换行
        Php::out << std::endl;
    Php::out.flush();
}

로그인 후 복사

PHP 테스트 코드

<?php
//打印100以内的素数
mm_print_pn_100();

로그인 후 복사

위 PHP 코드를 실행하면 출력 결과는

2 3 5 7 11 13 17 19 23 29
31 37 41 43 47 53 59 61 67 71
73 79 83 89 97

로그인 후 복사

2입니다. 매개 변수 및 반환 값 없이 확장 함수를 작성하는 방법

함수 함수: 1, 2, 3,... , 100 sum
함수 이름: mm_sum_1_100

함수 mm_sum_1_100을 등록하세요. 등록 방법은 이전 섹션과 동일합니다

extension.add<mm_sum_1_100>("mm_sum_1_100");

로그인 후 복사

함수 선언 및 코드는 다음과 같습니다.
함수에는 매개변수가 필요하지 않습니다. 함수 매개변수 목록을 비워두기만 하면 됩니다.
함수에는 반환 값이 있으며 반환 값 유형은 Php::Value로 설정됩니다. Php::value는 생성자와 연산자 = 연산자를 오버로드하므로 일반 데이터 유형(정수, 문자열, 부동 소수점 숫자, 배열 등)을 직접 반환할 수 있습니다.

//获取1-100的和
Php::Value mm_sum_1_100()
{
    int sum = 0;
    int i;
    for(i=1;i<=100;i++){
        sum += i;
    }
    return sum; //可以直接返回sum值，自动生成 Php::value 类型
}

로그인 후 복사

PHP 테스트 코드:

<?php
$sum = mm_sum_1_100();
echo &#39;sum (1~100) = &#39; . $sum . PHP_EOL;
?>

로그인 후 복사

위 PHP 코드를 실행하면 출력 결과는

sum (1~100) = 5050

로그인 후 복사

3입니다. 매개변수가 있고 반환 값이 없는 확장 함수를 작성하는 방법

함수 함수: 주어진 정수를 계산하고 값을 인쇄합니다. 정수 내 모든 소수

함수 이름: mm_print_pn_any

함수 mm_print_pn_any를 등록하세요. 등록 방법은 이전 섹션과 동일합니다.

extension.add<mm_print_pn_any>("mm_print_pn_any");

로그인 후 복사

함수 선언 및 코드는 다음과 같습니다. 매개변수는 필수이므로 함수 매개변수는 Php::Parameters ¶ms로 작성해야 합니다. 반환값이 없으므로 반환값 유형은 void로 설정됩니다.
또한, 매개변수가 입력되었는지 확인이 필요하고, 매개변수의 종류도 정수인지 확인이 필요합니다. 감지하지 않고 직접 사용하면 코드에서 예외가 발생하기 쉽습니다.

//任意给定一个整数，打印出小于等于该整数的所有素数
void mm_print_pn_any(Php::Parameters &params)
{
    //检查必须输入一个参数
    if(params.size() == 0){
        Php::out << "error: need a parameter " << std::endl;
        return;
    }
    //检查参数必须是整形
    if( params[0].type() != Php::Type::Numeric){
        Php::out << "error: parameter must be numeric" << std::endl;
        return;
    }
    //检查数字必须大于1
    int number = params[0];
    if(number <= 1){
        Php::out << "error: parameter must be larger than 1" << std::endl;
        return;
    }
    //检查参数必须大于0
    int x = 2;
    int y = 1;
    int line = 0;
    while (x <= number){
        int z = x - y; //z随y递减1
        int a = x%z; //取余数
        if (a == 0) { //如果x被z整除
            if (z == 1) {//如果z为1（x是质数）
                Php::out << x << " ";//输出x
                line ++;//每行输出的数的数量加1
             }
            x ++; //x加1
            y = 1;//y还原
        }
        else {//如果没有被整除
            y ++;//y加1，下一次循环中z减1
        }
        if (line == 10) {//每输出10个数
            Php::out << std::endl;//输出一个换行        
            line = 0;//还原line
        }
    }
    if (line != 0) //最后一行输出换行
        Php::out << std::endl;
    Php::out.flush();    
}

로그인 후 복사

PHP 테스트 코드

<?php
echo &#39;---runing mm_print_pn_any()---&#39; . PHP_EOL;
mm_print_pn_any();

echo PHP_EOL . &#39;---runing mm_print_pn_any(\&#39;xyz\&#39;)---&#39; . PHP_EOL;
mm_print_pn_any(&#39;xyz&#39;);

echo PHP_EOL . &#39;---runing mm_print_pn_any(200)---&#39; . PHP_EOL;
mm_print_pn_any(200);
?>

로그인 후 복사

위 PHP 코드를 실행하면 출력 결과는

---runing mm_print_pn_any()---
error: need a parameter

---runing mm_print_pn_any(&#39;xyz&#39;)---
error: parameter must be numeric

---runing mm_print_pn_any(200)---
2 3 5 7 11 13 17 19 23 29
31 37 41 43 47 53 59 61 67 71
73 79 83 89 97 101 103 107 109 113
127 131 137 139 149 151 157 163 167 173
179 181 191 193 197 199

로그인 후 복사

4입니다. 스칼라 매개변수, 반환 값으로 확장 함수 작성

함수 함수: 일련의 매개변수가 주어지면 해당 합계를 계산합니다

함수 이름: mm_sum_all

mm_sum_all 확장 함수를 등록합니다. 등록 방법은 이전 섹션과 동일합니다.

extension.add<mm_sum_all>("mm_sum_all");

로그인 후 복사

함수 선언 및 코드는 다음과 같습니다.

//获取所有参数的和
Php::Value mm_sum_all(Php::Parameters &params)
{
    int sum = 0;
    for (auto &param : params){
        //字符串类型可以自动转换成整形
        sum += param;
    }
    return sum;
}

로그인 후 복사

PHP 테스트 코드

<?php

$sum = mm_sum_all(1,2,&#39;3&#39;,&#39;5&#39;); //字符串类型可以自动转换成整形
echo &#39;sum (1,2,\&#39;3\&#39;,\&#39;5\&#39;) = &#39; . $sum . PHP_EOL;
?>

로그인 후 복사

테스트 출력 결과:

sum (1,2,&#39;3&#39;,&#39;5&#39;) = 11

로그인 후 복사

5. 배열형 매개변수, 반환 값으로 확장 함수 작성

함수 함수: 배열형 매개변수가 주어지면 배열의 모든 요소의 합을 계산합니다

함수 이름: mm_sum_array

mm_sum_array 함수를 등록하세요. 등록 방법은 첫 번째 섹션과 동일합니다.

함수 선언 및 코드는 다음과 같습니다.

//获取所有数组各元素的和
Php::Value mm_sum_array(Php::Parameters &params)
{
    //没有给定参数，返回0
    if(params.size() == 0){
        return 0;
    }
    //参数类型不是数组，转成整形返回
    if( params[0].type() != Php::Type::Array){
        return (int)params[0];
    }
    //数组中的元素逐个相加
    int sum = 0;
    Php::Value array = params[0];
    int size = array.size();
    int i;
    for(i=0;i<size;i++){
        sum += array.get(i);
    }
    return sum;
}

로그인 후 복사

PHP 테스트 코드

<?php
$nums = array(1,3,5,7);
$sum = mm_sum_array($nums);
echo &#39;sum (array(1,3,5,7)) = &#39; . $sum . PHP_EOL;
?>

로그인 후 복사

테스트 출력 결과:

sum (array(1,3,5,7)) = 16

로그인 후 복사

6. 반환 값 유형이 배열인 확장 함수 작성 방법

위 함수의 반환 값은 모두 스칼라 유형입니다. 특히 PHP에서 일반적으로 사용되는 유형을 반환하려는 경우 배열 유형의 경우 C++의 std::Vector를 사용할 수 있으며 PHP-CPP는 이를 PHP에서 인식하는 배열 유형으로 신중하게 변환합니다.

현재 데모 함수의 기능은 "30 이내의 모든 소수 배열을 반환"하는 것입니다. 확장 기능에 함수를 등록하는 방법은 첫 번째 섹션과 동일합니다.

함수 선언 및 코드는 다음과 같습니다.

//获取30以内的所有素数
Php::Value mm_get_pn_30()
{
    std::vector<int> pn;
    int x = 2;
    int y = 1;
    while (x <= 30){
        int z = x - y; //z随y递减1
        int a = x%z; //取余数
        if (a == 0) { //如果x被z整除
            if (z == 1) {//如果z为1（x是质数）
                pn.push_back(x); //放数组中去
            }
            x ++; //x加1
            y = 1;//y还原
        }
        else {//如果没有被整除
            y ++;//y加1，下一次循环中z减1
        }
    }    
    return pn;
}

로그인 후 복사

PHP 테스트 코드

<?php
$pn = mm_get_pn_30();
var_dump($pn);
?>

로그인 후 복사

테스트 출력 결과:

array(10) {
  [0]=>
  int(2)
  [1]=>
  int(3)
  [2]=>
  int(5)
  [3]=>
  int(7)
  [4]=>
  int(11)
  [5]=>
  int(13)
  [6]=>
  int(17)
  [7]=>
  int(19)
  [8]=>
  int(23)
  [9]=>
  int(29)
}

로그인 후 복사