Documentation clarifications - ext/session vs. ext-session, and "entry of" vs. "entry in"

[bitwombat]

The documentation at https://docs.zendframework.com/zend-session/config/
says

Zend\Session\Config\StandardConfig provides the base interface for configuring sessions when not leveraging ext/session

What is ext/session? Do they mean the "PHP session extension"?

If so, I'll do a PR with a global search/replace, because that really threw me off.

Also, https://docs.zendframework.com/zend-session/container/ says:

Each instance of Zend\Session\Container corresponds to an entry of the Zend\Session\Storage, where the namespace is used as the key.

What's meant by "corresponds to an entry of"? Do they mean "is an entry in"?

[weierophinney]

Yes, ext/session is the PHP session extension. It is commonly referred to as ext-session or ext/session. This is true of most extensions, and the former example (ext-session) is in fact the one Composer users to mark an extension as a requirement.

With regards to your second question, containers are namespaced. You give a container a name, such as "user", and all entries in that container are part of that virtual namespace. The name of the container then becomes an entry in the storage used. So, yes, a container corresponds to an entry in the storage. In my example, the "user" container becomes a "user" entry in the storage, containing all the values the container has.

[bitwombat]

Might be common, but it tripped me up and I'm not new to PHP. FWIW https://docs.zendframework.com/zend-expressive-session-ext/intro/ calls it

the PHP ext-session

And, as you point out, composer calls them ext-*. Dunno, must just be me, and I'm busy enough otherwise.

"entry in" vs. "entry of" - I'll make a record-setting-tiny PR for that :)

[froschdesign]

I know the spelling "ext/session" from PHP's "Test and Code Coverage Analysis":

• http://gcov.php.net/PHP_7_4/lcov_html/
• http://gcov.php.net/PHP_7_2/lcov_html/ext/session/mod_files.c.gcov.php

But it doesn't matter. In the documentation we need a consistent spelling.
I suggest to use "ext-session" which correlates with:

• Composer
• zend-expressive-session-ext
• and with some other descriptions and pages in code and documentation

@bitwombat
Can you provide a pull request, please?

---

(Or we use the long wording: "PHP's session extension". But this means we have to rewrite the title of zend-expressive-session-ext: "PSR-7 Sessions via ext-session".)

[bitwombat]

Will do @froschdesign.

I look at it as sort of namespace/context. ext-session could be a ZF thing otherwise.

But first, would it be OK with you if the body text was more explicit (ie. "PHP's ext-session"), allowing us to feel consistent while leaving the title of zend-expressive-session-ext alone?

[froschdesign]

@bitwombat

"PHP's ext-session"

Go for it! 👍

[weierophinney]

This repository has been closed and moved to laminas/laminas-session; a new issue has been opened at laminas/laminas-session#1.