Adding built-in symbol list

[kostajh]

PHP ships with a ton of built-in symbols that this library doesn't currently know about. In the final 1.0.0 release, I'd like to ship with a couple of files that have function stubs and detailed docblocks for every built in PHP function and class (and their methods/properties). It shouldn't be too difficult to extract this information from the PHP docs. When that PHP file is generated, it should be as simple as always including it in the symbol table.

Could we make use of http://doc.php.net/downloads/json/php_manual_en.json ?

If you can provide some direction of how to incorporate this, I could try to work on this.

[cweagans]

Oh, that's really cool! I was going to try to parse this data out of the gigantic HTML file.

So here's what I was thinking on this front:

• Write code to download and transform that JSON file into a normal PHP file, making sure to include as much information in the docblocks as possible. PhpStorm ships with something kind of like this: http://take.ms/RzDzl Note that the PHP Parser library also has code generation functionality, which is documented here: https://github.com/nikic/PHP-Parser/blob/master/doc/4_Code_generation.markdown
• Add that generated file to a new directory in the root of the project called data
• In cweagans\TheForce\Indexer, add a new protected method called getBuiltInFiles() and just have it return an array of absolute paths to any files that you've added in the data directory.
• In cweagans\TheForce\Indexer->rebuildFileList(), just change the first $this->fileList assignment to use the new getBuiltInFiles() method.

That should be all there is to it!

[cweagans]

I started some work on this in the add-php-symbols branch. Right now, it does most of the above things.

However, we're completely missing any classes that are built into PHP, as well as the child properties and methods. We're also missing any built-in PHP constants and arrays ($_SERVER and the like).

[cweagans]

Also, the docblocks in the generated files aren't that great (not full PHPdoc blocks).