1 PHP
2008/01/22 at
photo by Sara Golemon (flickr.com/photos/pollita/2093670535/)

... (01/05 18:46)

10

PHP
•
•
»
•

•CodeGen_PECL
Extension
•

• PC
• http://phpext.g.hatena.ne.jp/i_
ogi/20080119/1200758118

PHP (Extension)

PHP Extension
•C/C++
•PHP

•C PHP
»
(PHP)
•C
USB
»libusb

•C
•
•

...
C

Extension ( )
•mysql DB
PHP
PDO
•imagick
•Xdebug
PHP

Extension ( )
PHP C
•json (JSON )
•syck (YAML )

Extension ( )
Extension
•SimpleXML

Extension ( )
•runkit
•operator
PHP

•
•
»
»Sara
»PHP

Extending and Embedding PHP
• Sara Golemon
• Yahoo! Inc
runkit
•
•4 5

PHP5
• ,
()
•
•

PHP4 / 5

C
• PHP
•
5.2
»5.1
5.2.2
»5.2.1
•C

PHP4 is DEAD!!!
• PHP4
•PHP4
PHP5
»

welcome PHP5
•PHP5
OOP
»
»interface
•SPL
•SimpleXML

PHP6
•Unicode
•
•

CodeGen_PECL
Extension

• CodeGen_PECL XML
• pecl-gen
•
•
•

CodeGen_PECL ?
• XML PECL
• XML
• PHP5 PEAR
PHP4/5
4
»5

ext_skel
• PHP4 ext_skel
•
•
• CodeGen_PECL IF

• CodeGen_PECL
»
» http://www.m-takagi.org/
docs/php/CodeGen_PECL/
• PHP
2
gihyo.jp
»
» http://gihyo.jp/dev/serial/01/php-
module/0002

CodeGen_PECL
XML(Spec file)

XML ( )
• ( )
• PECL
»
•
» C or C++, platform(unix, win,all)
» --with (header, lib path)
Extension
»

XML ( )
• (function)
) code
»proto(
•
»MINIT, RINIT
»MSHUTDOWN, RSHUTDOWN
»MINFO
• OOP
PHP4 OOP
»CodeGen

XML ( )
• (constant)
• ini
•
•
XML

•
• \"study1\"
»

PHP
• : study1
• : study1_func()
• ini : study1.ini
• : STUDY1_CONSTANT

• hello world
•
<?php
function study1_greeting($name = \"\")
{
if (strlen($name)) {
echo \"Hello, $name!\", PHP_EOL;
} else {
echo \"Hello, World!\", PHP_EOL;
}
}
?>

•
»PHP
//
void funcname(void);
// int int
int funcname(int param);
Example 12.

// 1 2
//
string funcname(string param1
[[, string param2], string param3]);
//
int funcname([int param = 42]);
//
int funcname(string param1, ...);
//
object foo funcname(resource bar param1);
Example 12.

•
•
»
»
•

• 1
•
•
void study1_greeting([string name])

XML(Spec )

• XML <extension>
• name →
\"study1\"
»
<?xml version=\"1.0\" ?>
<!DOCTYPE extension SYSTEM \"../extension.dtd\">
<extension name=\"study1\">
</extension>

(function )
• name →
• <proto>
<function name=\"study1_greeting\">
<proto>void study1_greeting([string
name])</proto>
<code> </code>
<test> </test>
</function>

(code )
•C
•

• PHP
• : string name
•
»const char *name
int name_len
»
•
»

• http://www.m-
takagi.org/docs/php/CodeGen_P
ECL/x304.html#AEN377

<code>
if (name_len) {
//php_printf(\"Hello, %s%s\",
name, PHP_EOL);
php_printf(\"Hello, \");
PHPWRITE(name, name_len);
php_printf(\"!%s\", PHP_EOL);
} else {
php_printf(\"Hello, World!%s\",
PHP_EOL);
}
</code>

(function test )
•
• test
<test>
<code> </code>
<result mode=\"plain\"> </result>
</test>

(function test )
•
<test>
<code>study1_greeting();study1_gre
eting(\"Japan\");</code>
<result mode=\"plain\">Hello, World!
Hello, Japan!</result>
</test>

<?xml version=\"1.0\" ?>
<!DOCTYPE extension SYSTEM \"../extension.dtd\">
<extension name=\"study1\">
<function name=\"study1_greeting\">
<proto>void study1_greeting([string name])</proto>
<code>
if (name_len) {
//php_printf(\"Hello, %s%s\", name, PHP_EOL);
php_printf(\"Hello, \");
PHPWRITE(name, name_len);
php_printf(\"!%s\", PHP_EOL);
} else {
php_printf(\"Hello, World!%s\", PHP_EOL);
}
</code>
<test>
<code>study1_greeting();study1_greeting(\"Japan\");</code>
<result mode=\"plain\">Hello, World!
Hello, Japan!</result>
</test>
</function>
</extension>

XML
specfile.xml

pecl-gen

pecl-
pecl-gen specfile.xml

OK
$ pecl-gen specfile.xml
Warning: no 'version' attribute given for
<extension>, assuming 1.1.0
this may lead to compile errors if your
spec file was created for an older version
Creating 'study1' extension in './study1'
Your extension has been created in
directory ./study1.
See ./study1/README and/or ./study1/INSTALL
for further instructions.

study1
cd
$ cd study1

•phpize ( )
•./configure
•make
•make test
•sudo make install

phpize
$ phpize
Configuring for:
PHP Api Version: 20041225
Zend Module Api No: 20060613
Zend Extension Api No: 220060519

./configure
$ ./configure
checking for grep that handles long lines and
-e... /bin/grep
checking for egrep... /bin/grep -E
checking for a sed that does not truncate
output... /bin/sed
checking for gcc... gcc
checking for C compiler default output file
name... a.out
...
appending configuration tag \"F77\" to libtool
configure: creating ./config.status
config.status: creating config.h

make
$ make
...
----------------------------------------------------------------------
Libraries have been installed in:
/home/iogiwara/work/extstudy/080122/2/study1/modules
If you ever happen to want to link against installed libraries
in a given directory, LIBDIR, you must either use libtool, and
specify the full pathname of the library, or use the `-LLIBDIR'
flag during linking and do at least one of the following:
- add LIBDIR to the `LD_LIBRARY_PATH' environment variable
during execution
- add LIBDIR to the `LD_RUN_PATH' environment variable
during linking
- use the `-Wl,--rpath -Wl,LIBDIR' linker flag
- have your system administrator add LIBDIR to `/etc/ld.so.conf'
See any operating system documentation about shared libraries for
more information, such as the ld(1) and ld.so(8) manual pages.
----------------------------------------------------------------------
Build complete.
Don't forget to run 'make test'.

make test
•
• make test
php.ini extension

make test
$ make test
...
=====================================================================
CWD : /home/iogiwara/work/extstudy/080122/2/study1
PHP : /usr/bin/php
PHP_SAPI : cli
PHP_VERSION : 5.2.3-1ubuntu6.3
ZEND_VERSION: 2.2.0
PHP_OS : Linux - Linux ubuntu-desktop 2.6.22-14-generic #1 ...
INI actual : /etc/php5/cli/php.ini
More .INIs :
Extra dirs :
=====================================================================
Running selected tests.
PASS study1_greeting() function [tests/study1_greeting.phpt]
=====================================================================
Number of tests : 1 1
Tests skipped : 0 ( 0.0%) --------
Tests warned : 0 ( 0.0%) ( 0.0%)
Tests failed : 0 ( 0.0%) ( 0.0%)
Tests passed : 1 (100.0%) (100.0%)
---------------------------------------------------------------------
Time taken : 0 seconds
=====================================================================

sudo make install
$ sudo make install
Installing shared extensions:
/usr/lib/php5/20060613+lfs/

•
»-d extension=○
»-r
$ php -dextension=study1.so –r
'study1_greeting();'
Hello, World!

CodeGen_PECL

•CodeGen_PECL ext_skel
•

•
»http://gihyo.jp/dev/serial/01/php
-module/0002?page=2
•
•C
• config.m4