ZF reference guide or how to use a single component

[Thomas Weidner]

Hy interested ones,

I just added a new reference table to the documentation where people can see
which ZF component depends on which other ZF component.

So if anyone is in need of just one component like Zend_Log he can just look
into this table and see which other components he has also to provide that
all works properly.

I hope this comes handy to people, especially to the one which declare not
to have much space. :D

Related to the reference tables in general.
It would be great if anyone could update the tables (extensions) and/or test
the actual content. I think the extensions section is outdated as several
new components have been added and existing ones provide new features.
Maybe add a testbed for this case ? I don't know...

Greetings
Thomas Weidner, I18N Team Leader, Zend Framework
http://www.thomasweidner.com 

[weierophinney]

-- Thomas Weidner <[hidden email]> wrote
(on Tuesday, 10 June 2008, 03:25 PM +0200):
> I just added a new reference table to the documentation where people can
> see which ZF component depends on which other ZF component.

Where is this? Do you have it built anywhere?

> So if anyone is in need of just one component like Zend_Log he can just
> look into this table and see which other components he has also to
> provide that all works properly.

Does this take into consideration optional dependencies? For instance,
Zend_Db can be used _without_ Zend_Config, but can also consume it.

> I hope this comes handy to people, especially to the one which declare
> not to have much space. :D
>
> Related to the reference tables in general.
> It would be great if anyone could update the tables (extensions) and/or
> test the actual content. I think the extensions section is outdated as
> several new components have been added and existing ones provide new
> features.
> Maybe add a testbed for this case ? I don't know...

--
Matthew Weier O'Phinney
Software Architect       | [hidden email]
Zend Framework           | http://framework.zend.com/

[Thomas Weidner]

Matthew,

> Where is this? Do you have it built anywhere?

Revision 9654 - english documentation file requirements where the other 2
reference tables I created in past are also located.

> Does this take into consideration optional dependencies? For instance,
> Zend_Db can be used _without_ Zend_Config, but can also consume it.

Yes and no...
Actually it has a hard and soft dependence...
Hard means that the component uses the other component somewhere in code.
Soft means that this is a optional subcomponent so the dependency could be
related to the users usage of this component.

It's all written in the documentation.

Actually Zend_Db has a hard dependency to Zend_Config as it's required in
base of the abstract adapter class and every one uses a adapter.

I am sure my table is not complete or perfect, as also the other two are
not. But they are better than having nothing.
That's why I asked if anyone could do a test to verify this.
All my data is directly from the actual trunk in core.

Greetings
Thomas Weidner, I18N Team Leader, Zend Framework
http://www.thomasweidner.com

----- Original Message -----
From: "Matthew Weier O'Phinney" <[hidden email]>
To: <[hidden email]>; <[hidden email]>
Sent: Tuesday, June 10, 2008 3:37 PM
Subject: Re: ZF reference guide or how to use a single component

> -- Thomas Weidner <[hidden email]> wrote
> (on Tuesday, 10 June 2008, 03:25 PM +0200):
>> I just added a new reference table to the documentation where people can
>> see which ZF component depends on which other ZF component.
>
> Where is this? Do you have it built anywhere?
>
>> So if anyone is in need of just one component like Zend_Log he can just
>> look into this table and see which other components he has also to
>> provide that all works properly.
>
> Does this take into consideration optional dependencies? For instance,
> Zend_Db can be used _without_ Zend_Config, but can also consume it.
>
>> I hope this comes handy to people, especially to the one which declare
>> not to have much space. :D
>>
>> Related to the reference tables in general.
>> It would be great if anyone could update the tables (extensions) and/or
>> test the actual content. I think the extensions section is outdated as
>> several new components have been added and existing ones provide new
>> features.
>> Maybe add a testbed for this case ? I don't know...
>
> --
> Matthew Weier O'Phinney
> Software Architect       | [hidden email]
> Zend Framework           | http://framework.zend.com/ 

[weierophinney]

-- Robin Skoglund <[hidden email]> wrote
(on Tuesday, 10 June 2008, 03:57 PM +0200):

> On Tue, Jun 10, 2008 at 3:37 PM, Matthew Weier O'Phinney <[hidden email]>
> wrote:
>     -- Thomas Weidner <[hidden email]> wrote
>     (on Tuesday, 10 June 2008, 03:25 PM +0200):
>     > I just added a new reference table to the documentation where people can
>     > see which ZF component depends on which other ZF component.
>
>     Where is this? Do you have it built anywhere?
>
>     > So if anyone is in need of just one component like Zend_Log he can just
>     > look into this table and see which other components he has also to
>     > provide that all works properly.
>
>     Does this take into consideration optional dependencies? For instance,
>     Zend_Db can be used _without_ Zend_Config, but can also consume it.
>
>
> Isn't that a requirement nonetheless? At some point there is a check like 'if
> ($config instance of Zend_Config)', which means the class requires Zend_Config
> to do the check.

Actually, in recent PHP versions (I'm not sure when it started exactly;
somebody will chime in, I'm sure), the class does not need to be loaded
for instanceof checks to succeed, so this is still a soft dependency.

>     > I hope this comes handy to people, especially to the one which declare
>     > not to have much space. :D
>     >
>     > Related to the reference tables in general.
>     > It would be great if anyone could update the tables (extensions) and/or
>     > test the actual content. I think the extensions section is outdated as
>     > several new components have been added and existing ones provide new
>     > features.
>     > Maybe add a testbed for this case ? I don't know...

--
Matthew Weier O'Phinney
Software Architect       | [hidden email]
Zend Framework           | http://framework.zend.com/

[weierophinney]

-- Vincent <[hidden email]> wrote
(on Tuesday, 10 June 2008, 04:57 PM +0200):

>
>
> On 6/10/08, Matthew Weier O'Phinney <[hidden email]> wrote:
>
>     -- Robin Skoglund <[hidden email]> wrote
>     (on Tuesday, 10 June 2008, 03:57 PM +0200):
>
>     > On Tue, Jun 10, 2008 at 3:37 PM, Matthew Weier O'Phinney <
>     [hidden email]>
>     > wrote:
>     >     -- Thomas Weidner <[hidden email]> wrote
>     >     (on Tuesday, 10 June 2008, 03:25 PM +0200):
>     >     > I just added a new reference table to the documentation where
>     people can
>     >     > see which ZF component depends on which other ZF component.
>     >
>     >     Where is this? Do you have it built anywhere?
>     >
>     >     > So if anyone is in need of just one component like Zend_Log he can
>     just
>     >     > look into this table and see which other components he has also to
>     >     > provide that all works properly.
>     >
>     >     Does this take into consideration optional dependencies? For
>     instance,
>     >     Zend_Db can be used _without_ Zend_Config, but can also consume it.
>     >
>     >
>     > Isn't that a requirement nonetheless? At some point there is a check like
>     'if
>     > ($config instance of Zend_Config)', which means the class requires
>     Zend_Config
>     > to do the check.
>
>
>     Actually, in recent PHP versions (I'm not sure when it started exactly;
>     somebody will chime in, I'm sure), the class does not need to be loaded
>     for instanceof checks to succeed, so this is still a soft dependency.
>
>
>
> http://nl2.php.net/instanceof
>
>
>     There are a few pitfalls to be aware of. Before PHP version 5.1.0,
>     instanceof would call __autoload() if the class name did not exist. In
>     addition, if the class was not loaded, a fatal error would occur. This can
>     be worked around by using a dynamic class reference, or a string variable
>     containing the class name:
>
> :)

Which means ZF is safe in this regard, as our minimum supported version
is 5.1.4. :-)

--
Matthew Weier O'Phinney
Software Architect       | [hidden email]
Zend Framework           | http://framework.zend.com/