The phpDocumentor package provides automatic documenting of php api directly from the source.
Several other PHP projects provide packages of their software that are installable using the PEAR infrastructure. A list of these projects can be found in the channels section.