Doc #76655 [Opn->Csd]: libsodium seems not present, "no installation needed" not true

From: Date: Mon, 23 Jul 2018 10:41:43 +0000
Subject: Doc #76655 [Opn->Csd]: libsodium seems not present, "no installation needed" not true
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-15921@lists.php.net to get a copy of this message
Edit report at https://bugs.php.net/bug.php?id=76655&edit=1

 ID:                 76655
 Updated by:         cmb@php.net
 Reported by:        it-solutions at schultz dot ch
 Summary:            libsodium seems not present, "no installation
                     needed" not true
-Status:             Open
+Status:             Closed
 Type:               Documentation Problem
 Package:            *Encryption and hash functions
 Operating System:   Linux / Windows
 PHP Version:        7.2.8
-Assigned To:        
+Assigned To:        cmb
 Block user comment: N
 Private report:     N

 New Comment:

This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation better.


Previous Comments:
------------------------------------------------------------------------
[2018-07-23 10:41:05] cmb@php.net

Automatic comment from SVN on behalf of cmb
Revision: http://svn.php.net/viewvc/?view=revision&revision=345378
Log: Fix #76655: libsodium seems not present, "no installation needed" not true

------------------------------------------------------------------------
[2018-07-23 08:16:06] requinix@php.net

Unfortunately "core" can mean one of two things depending on who says it and in what
context: (a) it's bundled with the PHP source and available as an extension, or (b) it's
bundled with the source and baked-into PHP automatically. The former is more about the fact that
it's officially maintained by the PHP "core devs", as opposed to being something
third-party or in PECL, and the latter tends to mean the extension acts as a dependency for
important behavior (eg, ext/tokenizer).

Thing is, this is all still subject to how distributors want to deal with it. Particularly Linux,
which very often separates "core" stuff into optional packages to install. The Windows
download is about as close as it gets to some sort of "default" PHP installation.

And with the Windows download, sodium is an extension. So it's "core" in the first
sense.
On Windows you can get it by enabling that extension, and on Linux you'll probably have to
install some package.

------------------------------------------------------------------------
[2018-07-23 07:44:54] it-solutions at schultz dot ch

Description:
------------
Although PHP announced that with PHP 7.2 libsodium will be part of the PHP core and available
without any further action (see https://secure.php.net/manual/en/sodium.installation.php),
even in the latest PHP 7.2.8 it seems not to be accessible.

There are numerous reports on this issue on the web, some suggesting to install older libs (7.1)
instead.

I suggest the documentation clarifies, under which circumstances this new (and eagerly awaited)
feature is available "out of the box" (or what steps need to be taken to do so).




Test script:
---------------
<?php 
echo (SODIUM_LIBRARY_VERSION);
?>

Expected result:
----------------
shows library version number (which is stored in the named constant, see https://secure.php.net/manual/en/sodium.constants.php
)

Actual result:
--------------
shows the literal "SODIUM_LIBRARY_VERSION", so the constant is actually not existing


------------------------------------------------------------------------



--
Edit this bug report at https://bugs.php.net/bug.php?id=76655&edit=1


Thread (3 messages)

« previous php.doc.bugs (#15921) next »