PHP :: Doc Bug #79619 :: gethostname() should mention FQDN

Doc Bug #79619	gethostname() should mention FQDN
Submitted:	2020-05-21 19:33 UTC	Modified:	2020-05-22 14:01 UTC
From:	lkmorlan at uwaterloo dot ca	Assigned:
Status:	Re-Opened	Package:	*Network Functions
PHP Version:	Irrelevant	OS:
Private report:	No	CVE-ID:	None

View Developer Edit

Anyone can comment on a bug. Have a simpler test case? Does it work for you on a different platform? Let us know!
Just going to say 'Me too!'? Don't clutter the database with that please !

Your email address: MUST BE VALID
Solve the problem: 37 + 41 = ?
Subscribe to this entry?

[2020-05-21 19:33 UTC] lkmorlan at uwaterloo dot ca

Description:
------------
---
From manual page: https://php.net/function.gethostname
---
The documentation does not say anything about whether the return value is a fully-qualified domain name or not; sometimes it is, sometimes it is not.

It should mention that it could return either and explain what causes it to do one or the other.

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports

[2020-05-21 19:57 UTC] requinix@php.net

-Status: Open +Status: Not a bug

[2020-05-21 19:57 UTC] requinix@php.net

PHP is merely reporting what your system says. There's no logic about making it fully-qualified or not.

[2020-05-21 20:51 UTC] lkmorlan at uwaterloo dot ca

I suggest adding:

The value is the output of the system hostname command. Depending on system configuration, this will be either the fully-qualified domain name or just the local part of the name.

[2020-05-21 22:18 UTC] requinix@php.net

-Status: Not a bug +Status: Re-Opened -Package: Documentation problem +Package: *Network Functions

[2020-05-21 22:18 UTC] requinix@php.net

I wouldn't even mention fully-qualified - just say that it's from the system, consult your system's documentation, the usual that we do for functions like this.

[2020-05-22 14:01 UTC] lkmorlan at uwaterloo dot ca

OK, how about:

The value is the output of the system hostname command, which will depend on system configuration. Consult your system documentation.

	php.net \| support \| documentation \| report a bug \| advanced search \| search howto \| statistics \| random bug \| login
go to bug id or search bugs for


Copyright © 2001-2025 The PHP Group All rights reserved.	Last updated: Fri Oct 31 13:00:01 2025 UTC