php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #74237 Missing link to ref for further info on problems and missing info on packages
Submitted: 2017-03-11 12:16 UTC Modified: 2017-04-16 04:22 UTC
From: markjballard at googlemail dot com Assigned: peehaa (profile)
Status: No Feedback Package: Documentation problem
PHP Version: Irrelevant OS: linux
Private report: No CVE-ID: None
Have you experienced this issue?
Rate the importance of this bug to you:

 [2017-03-11 12:16 UTC] markjballard at googlemail dot com
Description:
------------
---
From manual page: http://www.php.net/install.unix.debian
---
The manual page says look elsewhere if there's a problem with php on a debian system because its probably a problem with the debain configuration:

"If the PHP scripts are not parsing via the web server, then it's likely that PHP was not added to the web server's configuration file, which on Debian may be /etc/apache2/apache2.conf or similar. See the Debian manual for further details."

But it neglects to provide a link to the manual where this help can be found. When you go looking, you learn that the debian manaual pages are a maze.

Telling users to go look elsewhere if php doesn't work is, moreover passing the buck.

The page also seems to discuss the installation as though the writer imagined he was addressing his advice to people who were already experts on the topic.

It talks loosely of a need to install various php packages without saying clearly what php packages are available, which ones need to be installed and, of the others, why you might want to install them. A simple list would help, with links to further info. 

Using the apt-cache search instruction the page suggests using to see what packages are available produces a small list that contains none of those packages referenced in the example install instructions.


Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2017-04-05 09:36 UTC] peehaa@php.net
-Status: Open +Status: Feedback -Assigned To: +Assigned To: peehaa
 [2017-04-05 09:36 UTC] peehaa@php.net
> It talks loosely of a need to install various php packages without saying clearly what php packages are available, which ones need to be installed and, of the others, why you might want to install them. A simple list would help, with links to further info. 

Imo the packages to be installed depend on specific use cases and requirements of the user and as such cannot really by explained what packages are needed and why.

Also as said we do not support unofficial builds from third-parties in the manual pages.

If you have a link to the correct debian manual page(s) fell free to share them so they can be linked, but as you said it's a maze.
 [2017-04-16 04:22 UTC] php-bugs at lists dot php dot net
No feedback was provided. The bug is being suspended because
we assume that you are no longer experiencing the problem.
If this is not the case and you are able to provide the
information that was requested earlier, please do so and
change the status of the bug back to "Re-Opened". Thank you.
 
PHP Copyright © 2001-2019 The PHP Group
All rights reserved.
Last updated: Wed Nov 13 21:01:42 2019 UTC