Skip to content

Commit 2c27a68

Browse files
7snovicjpauli
authored and
jpauli
committed
mention the new ext_skel (#34)
Good one , thx
1 parent 181d0b5 commit 2c27a68

File tree

1 file changed

+38
-0
lines changed

1 file changed

+38
-0
lines changed

Book/php7/extensions_design/extension_skeleton.rst

+38
Original file line numberDiff line numberDiff line change
@@ -199,6 +199,44 @@ macro.
199199

200200
After that, there is nothing more to say as everything is commented out and should be clear to you.
201201

202+
New age of the extension skeleton generator
203+
*******************************************
204+
205+
Since `this commit <https://github.com/php/php-src/commit/f35f45906eac34498c7720326fb9da9fde960871>`_ and the
206+
extension skeleton generator had took a new style :
207+
208+
209+
It will now run on Windows without Cygwin and other nonsense.
210+
It no longer includes a way to generate XML documentation (the PHP documentation utilities already got tools for that
211+
in svn under phpdoc/doc-base) and it no longer support function stubs.
212+
213+
and here is the available options :
214+
215+
.. code-block:: shell
216+
217+
php ext_skel.php --ext <name> [--experimental] [--author <name>]
218+
[--dir <path>] [--std] [--onlyunix]
219+
[--onlywindows] [--help]
220+
221+
--ext <name> The name of the extension defined as <name>
222+
--experimental Passed if this extension is experimental, this creates
223+
the EXPERIMENTAL file in the root of the extension
224+
--author <name> Your name, this is used if --header is passed and
225+
for the CREDITS file
226+
--dir <path> Path to the directory for where extension should be
227+
created. Defaults to the directory of where this script
228+
lives
229+
--std If passed, the standard header and vim rules footer used
230+
in extensions that is included in the core, will be used
231+
--onlyunix Only generate configure scripts for Unix
232+
--onlywindows Only generate configure scripts for Windows
233+
--help This help
234+
235+
The new extension skeleton generator will generate skeleton with three fixed functions,
236+
you may define any others functions and change the concrete body as you want.
237+
238+
.. note:: Remember that the new ext_skel is no longer support proto files.
239+
202240
Publishing API
203241
**************
204242

0 commit comments

Comments
 (0)