https://github.com/phplang/extension-tutorial-gmp

Follow-along slides for Extension Writing (with GMP)
https://github.com/phplang/extension-tutorial-gmp

Last synced: 3 months ago
JSON representation

Follow-along slides for Extension Writing (with GMP)

• Host: GitHub
• URL: https://github.com/phplang/extension-tutorial-gmp
• Owner: phplang
• Created: 2019-05-21T12:20:25.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2019-05-21T17:03:04.000Z (over 5 years ago)
• Last Synced: 2024-07-18T02:51:55.558Z (4 months ago)
• Language: C
• Size: 5.86 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# PHP Extension Writing Tutorial

## Prerequisites

Before beginning this tutorial, you'll need a development environment with the following packages:

  * Compiler: `gcc` and `clang` are both excellent choices.

  * Build tools: `autoconf`, `automake`, `libtool`

  * (Optional) parser generators: `re2c` and `bison`

  * PHP 7.x with development headers:

    * Either distro packages such as: `php7` and `php7-devel`

    * PHP compiled from source and installed with `sudo make install`. If compiling from source, then the `--enable-debug` switch is recommended, as well as the optional re2c and bison packages.

  * `libgmp` and development headers: As part of this tutorial, we'll eventually be linking against libgmp.  Install the library and it's associated development headers from your distro or install from source.

Obviously, you'll want this repo checked out in your build environment as well.

Be sure to `git pull` to make sure you have the most recent version.

## Format

This tutorial is split into steps, with one commit per step.

At each commit, you should be able to compile the extension code

as-provided using the following steps:

### Generate ./configure script using phpize

```sh

$ phpize

Configuring for:

PHP Api Version:         20170718

Zend Module Api No:      20170718

Zend Extension Api No:   320170718

```

### Generate Makefile using ./configure

```sh

$ ./configure

checking ...

checking ...

checking ...

[ lots of output ]

configure: creating ./config.status

config.status: creating config.h

```

### Build your extension

```sh

$ make

/bin/bash .../libtool --mode=compile cc  -I. -DPHP_ATOM_INC -I/usr/local/include/php -I/usr/local/include/php/main -I/usr/local/include/php/TSRM -I/usr/local/include/php/Zend -I/usr/local/include/php/ext -DHAVE_CONFIG_H -g -O0 -c mygmp.c modules/mygmp.so

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

Libraries have been installed in:

   .../modules

Build complete.

Don't forget to run 'make test'.

```

### Check to be sure it loads

```sh

$ php -d extension=modules/mygmp.so --re mygmp

Extension [  extension #40 mygmp version  ] {

}

```