php-stubs's Introduction
from http://youtrack.jetbrains.net/issue/WI-174: STUBS are normal, syntactically correct PHP files that contain function & class signatures, constant definitions, etc. for all built in PHP stuff and most standard extensions. Stubs need to include complete PHPDOC, especially proper @return annotations IDE need them for completion, code inspection, type inference, doc popups, etc. Quality of most of this services depend on quality of the stubs (basically their PHPDOC @annotations). Exactly the same kind of stubs is used for similar purposes by NetBeans PHP and Eclipse PDT. Stubs are currently located in /plugins/php/lib/php.jar/com/jetbrains/php/lang/psi/stubs/data/ within PhpStorm distribution. Don't forget to invalidate caches if you update anything there. It seems that there's no reliable automatic way to generate stubs from PHP sources/docs. Perhaps crowdsourcing is the solution. As for organisation of the process and tools involved I think its too early to start something big. At the moment everyone can look into what IS documented just by peeking into distribution. If anybody actually started work on some extension - just create a separate ticket and attach a file to it. I'll look into it and merge into the distro. If you had some generation tools or scripts or just insights to share - do not hesitate to drop a message. I will cleanup the thread if it gets too big and we will change process to something more appropriate if there will be some significant activity here. Legal notice: we do accept stub patches along with link to publicly available source of information used to make them. i.e. you prepare them (basically transform to appropriate form) from official (and public) documentation.
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. ๐๐๐
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google โค๏ธ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.