正则表达式如何使正则表达式以秒/ **为起点

Question

Here is the $source example

/**
 * These functions can be replaced via plugins. If plugins do not redefine these
 * functions, then these will be used instead.
 */

if ( !function_exists('wp_set_current_user') ) :
/**
 * Changes the current user by ID or name.
 *
 */
function wp_set_current_user($id, $name = '') {

Attention: some don't have the function_exists line.

For my special purpose, I'm trying to parse the docblock with regular expression.

Here is the regex

$t = preg_match_all("@(/\*\*.*?\*/
function\s.*?\(.*?\))\s{@mis",$source,$m);

I expect to get:

    /**
     * Changes the current user by ID or name.
     *
     */
    function wp_set_current_user($id, $name = '') {

but instead, it returns me the whole code example.

Any help would be appreciated.

---

I find out some people ask me my purpose, I don't think this is important here though.

I'm using geany and I find out existing wordpress code hint isn't complete.

And the docblock parsers I found that don't parse function name and function arguments.

So I try to parse them on my own.

the code hint format of geany is

wp_set_current_user|Changes the current user by ID or name.|($id, $name = '')|

However, my point of this question is how to make regex take second "/**" as starting point? I'm sorry for my poor English that confused you all.

Answer 1

You can parse comment out by regexp like this (check out Regex look around tutorial):

/\*\*/(?:(?:.(?!\*\*/))*)\*\*/

Then any number of white spaces can occur:

[\s]*

What keywords can function have in php? static, virtual, final, public, private, protected _{correct me if I'm forgetting something}.

(?:(?:static|virtual|final|public|private|protected)\s+)*

Okay, now function header and braces:

function\s+(?P<name>\w\d_+)\s*\(...\)

The ... parts get's complicated because it can contain default value which can be complicated php string ($remove_characters = '\'" '), so parsing value (string, string, number, constant):

"[^"\\\\]*(?:\\\\.[^"\\\\]*)*"
\'[^\'\\\\]*(?:\\\\.[^\'\\\\]*)*'
[\d.]+
\w+

Resulting to one large value regexp:

("[^"\\\\]*(?:\\\\.[^"\\\\]*)*"|\'[^\'\\\\]*(?:\\\\.[^\'\\\\]*)*'|[\d.]+|\w+)

And every function argument has a format $var or $var = data (of course any number of spaces + I'm omitting array $input = array()) so this is simplified var name matching:

\\$[\w_][\w\d_]*

Type matching:

([\w_]+\s+)?

So function arguments can be:

\s*([\w_]+\s+)?(\\$[\w_][\w\d_]*|\\$[\w_][\w\d_]*\s*=\s*<value>)

And complete regexp for function would look like:

function\s+(?P<name>\w\d_+)\s*\(\s*|<argument>((,<argument>)*)\)

I won't be testing those regexp for you, it's your job to do so at this point, my goal was to show you what you need if you want to do this really correctly (but feel free to edit my answer if you find a mistake).You may also use really simplified version (like just one regexp for function arguments eating everything).