# How to contribute for PHP Internals

- Thread: https://externals.io/message/43923
- Original archive: https://news-web.php.net/php.internals/43923
- Started by Sahid Ferdjaoui on 2009-05-14T08:50:22+00:00
- Messages: 11
- Reply by email to internals@lists.php.net
- More for agents: search with https://externals.io/search.md?q={query} · RFCs at https://externals.io/rfc.md · JSON API at https://externals.io/api · documentation at https://externals.io/llms.txt

---

## #43923 — Sahid Ferdjaoui — 2009-05-14T08:50:22+00:00

URL: https://externals.io/message/43923#43923

Hello Internals,

I want to contribute for PHP Internal,
but i don't know how to do it.

I am ready to give approximately 6 to 12 hours per week for PHP.

i have checked a wiki,
but i don't see a "get involved" section and i do not know how to start :)

about me :
I'm french, i have 24 years,	 I live in Paris,
i have some experiences in C, PHP and GNU Tools.
if you want to know more about me,
you can see my blog: http://sahid.funraill.org or my little projects :
http://code.google.com/p/ootemplate/
http://code.google.com/p/postmemd/

lots of thanks,
Sahid Ferdjaoui

--
~/sahid
http://sahid.funraill.org

---

## #43927 — David Coallier — 2009-05-14T16:16:56+00:00

URL: https://externals.io/message/43923#43927 · In reply to: #43923

2009/5/14 Sahid Ferdjaoui <sahid.ferdjaoui@gmail.com>:
> Hello Internals,
>
> I want to contribute for PHP Internal,
> but i don't know how to do it.
>
> I am ready to give approximately 6 to 12 hours per week for PHP.
>
> i have checked a wiki,
> but i don't see a "get involved" section and i do not know how to start :)
>

The best way to get started is to check http://php.net/anoncvs make a
checkout of HEAD (php6) and then go to http://bugs.php.net start
making patches and attach them to bug reports.

From there you will gain developers trust (People will be tired of
committing all your patches) and at some point you'll be granted with
an account :)

Good luck and welcome :)

-- 
Slan,
David

---

## #43940 — Sahid Ferdjaoui — 2009-05-14T17:45:54+00:00

URL: https://externals.io/message/43923#43940 · In reply to: #43927

Hello David,

I will follow your advice now :)

Thanks !

--
~/sahid
http://sahid.funraill.org




> 2009/5/14 Sahid Ferdjaoui <sahid.ferdjaoui@gmail.com>:
> > […]
>
> The best way to get started is to check http://php.net/anoncvs make a
> checkout of HEAD (php6) and then go to http://bugs.php.net start
> making patches and attach them to bug reports.
>
> From there you will gain developers trust (People will be tired of
> committing all your patches) and at some point you'll be granted with
> an account :)
>
> Good luck and welcome :)
>
> --
> Slan,
> David

---

## #43941 — Christopher Jones — 2009-05-14T18:03:40+00:00

URL: https://externals.io/message/43923#43941 · In reply to: #43927

David Coallier wrote:
> 2009/5/14 Sahid Ferdjaoui <sahid.ferdjaoui@gmail.com>:
> > […]
> 
> The best way to get started is to check http://php.net/anoncvs make a
> checkout of HEAD (php6) and then go to http://bugs.php.net start
> making patches and attach them to bug reports.
> 
> From there you will gain developers trust (People will be tired of
> committing all your patches) and at some point you'll be granted with
> an account :)
> 
> Good luck and welcome :)
> 

Yes, welcome!

Perhaps you could create a "get involved" wiki section based on what you
find out about getting involved?

Chris

-- 
Email: christopher.jones@oracle.com
Twitter:  http://twitter.com/ghrd

---

## #43982 — Sahid Ferdjaoui — 2009-05-15T10:58:01+00:00

URL: https://externals.io/message/43923#43982 · In reply to: #43941

Yes, why not :)

By get involved section,
i seek a guideline for contribute for each different points.

* Internal development
  * References
    * TSRM
    * Zend Engine API
    * ...
  * Coding standard
  * Get Started
      * Features
      * Bugs
        * motivate ? go to seek a bug now !
        * ok, no panic, explain and purpose a patch
        * ...
* Pecl development
  * How to (ok ...Sara Golemon's book)
  * What php need ?
* QA
* Documentation

Because php is a very big project and it is dificulte to say:
"No problem Rasmus...,
 you can take a nap, i will fix this bug." ;)

for example i like it :
http://live.gnome.org/JoinGnome

--
~/sahid
http://sahid.funraill.org



On Thu, May 14, 2009 at 8:03 PM, Christopher Jones
<christopher.jones@oracle.com> wrote:
>
>
> David Coallier wrote:
> > […]
>
> Yes, welcome!
>
> Perhaps you could create a "get involved" wiki section based on what you
> find out about getting involved?
>
> Chris
>
> --
> Email: christopher.jones@oracle.com
> Twitter:  http://twitter.com/ghrd

---

## #44025 — johannes@php.net — 2009-05-18T16:54:05+00:00

URL: https://externals.io/message/43923#44025 · In reply to: #43982

> Yes, why not :)
> 
> By get involved section,
> i seek a guideline for contribute for each different points.
> 
> * Internal development
>   * References
>     * TSRM
>     * Zend Engine API
>     * ...

Some documentation on this exists in the manual:
      http://php.net/internals2
Not sure how much but we might try to revive the internals-doc-writing
efforts...

>   * Coding standard

http://de2.php.net/reST/php-src/CODING_STANDARDS

>   * Get Started
>       * Features
>       * Bugs
>         * motivate ? go to seek a bug now !
>         * ok, no panic, explain and purpose a patch
>         * ...

Would help if the Bug Tracker was extended to mark (hopefully) low
hanging fruits for starters....

[...]

so lot's of information *is* available but very unstructured and
distributed over many places.
So a start might be to collect the links to one place with some guiding
comments...

> for example i like it :
> http://live.gnome.org/JoinGnome

That recently drove me nuts, I just wanted to locate the current VCS
repository one of their projects was using for creating a simple patch,
which I had ready against an older release but there was too much
"irrelevant" information hiding the things  was looking for. No I'm not
looking for a Gtk tutorial, not for a mentor, not for love (well, maybe
I do, but not related to gnome), ...

But that's actually the tough part: Don't become too verbose while
providing tons of information while again be motivational to beginners,
too.

johannes

---

## #44035 — Philip Olson — 2009-05-22T17:02:22+00:00

URL: https://externals.io/message/43923#44035 · In reply to: #44025

Great topic... a few thoughts:

- Internals documentation

This task needs volunteers. Ideally a mix of people who have either  
no, some or enormous knowledge of internals but all with desire to  
both learn and teach it. Gwynne started the task but ran out of steam  
(life and the svn migration got in the way) but some good content  
exists. But, this is its own topic. Volunteers please email me and  
let's organize a hackfestish type event.

- Bug tracker as a starting point

The idea of intentionally creating nice bug reports for fairly simple  
non-critical issues, and promoting these as tasks for new people  
definitely sounds worth the extra effort. All ideas for how the bug  
tracker could help with this are welcome.

- A "Get Involved" guide

Some nice thoughts in this thread, and similar ones for a _rough_ TOC  
here:

   - http://wiki.php.net/doc/scratchpad/wheretohelp

The basic idea is to create and promote a "Get Involved" section. To  
digress, awhile back while thinking about this (and wondering how the  
php.net project survives without it) I stumbled around and started a  
different yet related project:

   - http://teachingopensource.org/index.php/Teaching_Get_Involved

The plan is to learn how best to approach this topic and then apply it  
to php.net. If people are interested in working on this or only  
php.net specific parts then please let me know. So what that it's  
taken us 10 years to write a nice "Get Involved" guide, but at least  
we now have several resources to learn [steal!] ideas from while we  
create our own :) Common problems like repeated, lost and outdated  
content can no doubt be overcome.

Regards,
Philip

---

## #44036 — Patrick Serru — 2009-05-22T17:51:42+00:00

URL: https://externals.io/message/43923#44036 · In reply to: #44035

Le vendredi 22 mai 2009, Philip Olson a écrit :
> - Internals documentation
> 
> This task needs volunteers. Ideally a mix of people who have either  
> no, some or enormous knowledge of internals but all with desire to  
> both learn and teach it. Gwynne started the task but ran out of steam  
> (life and the svn migration got in the way) but some good content  
> exists. But, this is its own topic. Volunteers please email me and  
> let's organize a hackfestish type event.
--------------------------
      Hi Philip,

      Why not! My natural language is french (nobody's perfect!) but let's 
try, never known, maybe I could help.

      Indeed, I was looking for some definition of PHP as language. I'm not 
a specialist, but HOBBIST well interested. I try to build a parser in PHP, 
and parsing PHP first! Then, I was just needing more material related to 
the language it self.

      For instance, here is my last interogation: I noted that a class, 
defined inside a function does not has a global scope, and if I well 
remember, this does not fit with my readings... Is it a bug, or have I a 
bad memory ?

      Sincerly

---

## #44038 — Shirish Padalkar — 2009-05-23T14:35:53+00:00

URL: https://externals.io/message/43923#44038 · In reply to: #44035

Hi Philip,
Here is one suggestion for the page
http://wiki.php.net/doc/scratchpad/wheretohelp

<http://wiki.php.net/doc/scratchpad/wheretohelp>In the Writing an extension

   - What is PECL?
   - Why PECL?


we can give a link to PECL page on pear website or wikipedia link for PECL.
It would be good who want to know more about PECL.

We can provide following links-
http://pecl.php.net/
OR
http://en.wikipedia.org/wiki/PHP_Extension_Community_Library#PECL

One more option is to show a small pop-up (just like as CVS on the page)
about PECL.

What you think?

2009/5/22 Philip Olson <philip@roshambo.org>

> Great topic... a few thoughts:
>
> - Internals documentation
>
> This task needs volunteers. Ideally a mix of people who have either no,
> some or enormous knowledge of internals but all with desire to both learn
> and teach it. Gwynne started the task but ran out of steam (life and the svn
> migration got in the way) but some good content exists. But, this is its own
> topic. Volunteers please email me and let's organize a hackfestish type
> event.
>
> - Bug tracker as a starting point
>
> The idea of intentionally creating nice bug reports for fairly simple
> non-critical issues, and promoting these as tasks for new people definitely
> sounds worth the extra effort. All ideas for how the bug tracker could help
> with this are welcome.
>
> - A "Get Involved" guide
>
> Some nice thoughts in this thread, and similar ones for a _rough_ TOC here:
>
>  - http://wiki.php.net/doc/scratchpad/wheretohelp
>
> The basic idea is to create and promote a "Get Involved" section. To
> digress, awhile back while thinking about this (and wondering how the
> php.net project survives without it) I stumbled around and started a
> different yet related project:
>
>  - http://teachingopensource.org/index.php/Teaching_Get_Involved
>
> The plan is to learn how best to approach this topic and then apply it to
> php.net. If people are interested in working on this or only php.netspecific parts then please let me know. So what that it's taken us 10 years
> to write a nice "Get Involved" guide, but at least we now have several
> resources to learn [steal!] ideas from while we create our own :) Common
> problems like repeated, lost and outdated content can no doubt be overcome.
>
> Regards,
> Philip
>
>
>
> --
> 
> 
>
>


-- 
_____ S H I R I S H _____

---

## #44039 — johannes@php.net — 2009-05-23T18:02:53+00:00

URL: https://externals.io/message/43923#44039 · In reply to: #44036

Bonsoir,


>       Indeed, I was looking for some definition of PHP as language. I'm not 
> a specialist, but HOBBIST well interested. I try to build a parser in PHP, 
> and parsing PHP first! Then, I was just needing more material related to 
> the language it self.

I think the language syntax definition is more a part r the genaral
documentation and too specific for a "getting started with internals"
document. The language definition is a small part of PHP ...

>       For instance, here is my last interogation: I noted that a class, 
> defined inside a function does not has a global scope, and if I well 
> remember, this does not fit with my readings... Is it a bug, or have I a 
> bad memory ?


$ php -nr 'function declare_class() { class Foo {} } declare_class(); var_dump(new Foo());'
object(Foo)#1 (0) {
}

Seems to work, or didn't I understand your problem?

johannes

---

## #44040 — johannes@php.net — 2009-05-23T18:08:17+00:00

URL: https://externals.io/message/43923#44040 · In reply to: #44038

Hi,


> Hi Philip,
> Here is one suggestion for the page
> http://wiki.php.net/doc/scratchpad/wheretohelp
> 
> <http://wiki.php.net/doc/scratchpad/wheretohelp>In the Writing an extension
> 
>    - What is PECL?
>    - Why PECL?
> 
> 
> we can give a link to PECL page on pear website or wikipedia link for PECL.
> It would be good who want to know more about PECL.

The entry point should have a quick summary to avoid having too many
links and sending users for basic information away. And linking to
Wikipedia for information abut OUR infrastructure feels absolutely
wrong, we should be able to explan what it is better than WP :-)

> We can provide following links-
> http://pecl.php.net/
> OR
> http://en.wikipedia.org/wiki/PHP_Extension_Community_Library#PECL
> 
> One more option is to show a small pop-up (just like as CVS on the page)
> about PECL.

No idea how to create them, not sure if such a small thing brings any
real benefit - reading "PHP Extension Community Library" without knowing
PECL won't tell you anything. A more verbose explanation is needed.

johannes
