Building Custom PHP Extensions
................................................................................................................I
COPYRIGHT.............................................................................................III
TRADEMARKS..........................................................................................III
ABOUT THE AUTHOR................................................................................III
MOTIVATION FOR THIS DOCUMENT..........................................................................................5
MOTIVATION FOR CREATING YOUR OWN PHP EXTENSION..............................................................5
GETTING STARTED............................................................................................................5
FIRST PHP EXTENSION..............................................................................6
BUILDING THE SHELL.........................................................................................................6
IMPLEMENTING THE EXTENSION............................................................................................12
SUMMARY....................................................................................................................16
BUILDING EXTENSIONS – THE DETAILS.....................................................16
EXT_SKEL....................................................................................................................17
MEMORY MANAGEMENT FUNCTIONS......................................................................................21
DIRECTORY AND FILE FUNCTIONS.........................................................................................22
CONFIG.M4 AND PHP’S AUTOMATIC BUILD SYSTEM...................................................................22
EXPORTED FUNCTIONS DELARATION......................................................................................25
CREATING CONSTANTS.....................................................................................................26
ARGUMENTS AND RETURN VALUES.......................................................................................27
Overview............................................................................................................27
Working with Scalar Types.................................................................................35
Working with Arrays...........................................................................................40
Working with Objects.........................................................................................52
Working with Resources.....................................................................................58
DUPLICATING VARIABLE CONTENTS.......................................................................................63
PRINTING INFORMATION....................................................................................................64
STARTUP AND SHUTDOWN FUNCTIONS...................................................................................67
CALLING USER FUNCTIONS................................................................................................69
INITIALIZATION FILE SUPPORT..............................................................................................73
CLASSES.....................................................................................................................81
FULL EXAMPLE.......................................................................................89
GLPK EXTENSION: CONFIG.M4..........................................................................................91
GLPK EXTENSION: IMPLEMENTATION....................................................................................92
GLPK EXTENSION: SUMMARY..........................................................................................108
SELF-CONTAINED EXTENSIONS..............................................................108
BUILDING EXTENSIONS FOR WINDOWS ..................................................109
BUILDING PHP ON WINDOWS..........................................................................................110
BUILDING A PHP EXTENSION ON WINDOWS..........................................................................114
SUMMARY..................................................................................................................116
CONCLUSION........................................................................................116
APPENDIX A: TABLE OF FIGURES............................................................118
APPENDIX B: TABLE OF TABLES.............................................................119
APPENDIX C: TABLE OF OUTPUT FROM EXAMPLES..................................120
INDEX..................................................................................................121
Page 2
