Deploying with    Cloudflare Pages

View logs

Maybe this exact page/bullet-point is the wrong place for such a list, but I'd say that the required extensions should be listed somewhere in the documentation for reference.

Nothing against it, but I don't know how to generate a list of needed default extensions ...

I took a quick trip to google and found that Composer might be able to do it (composer check-platform-reqs). And it does work on my local checkout, but doesn't appear to show all used extensions. It doesn't even list ext-mbstring, which is suggested in YOURLS' own composer.json—but it does show ext-curl.

Maybe this is a half-baked Composer feature? The result didn't change after composer self-update to 2.3.5.

As an alternative I tried out https://github.com/RogerGee/php-ext-depends, with a better (but still seemingly incomplete) result:

~/github/php-ext-depends$ php depends.php --suffix .php ../YOURLS
Core (builtin)
ctype
curl
date (builtin)
dom
filter
hash
iconv
json
mbstring
openssl
pcre (builtin)
PDO
posix
SPL (builtin)
standard (builtin)
zlib

Still, this should be most of what's required. Amendments can be made if users find something that isn't listed causes an error when missing.

(Also I just noticed that my branch name is wrong. How did I get an =? No idea.)

This list isn't accurate either. For instance, iconv is not required, see https://github.com/YOURLS/YOURLS/blob/master/includes/functions-formatting.php#L328-L331

I would suggest we

• add all the extension requirements / suggestions in YOURLS/YOURLS composer.json for reference
• only list on docs.yourls.org the common requirements as currently
• and mention on docs.yourls.org that common extensions needed are listed in the composer.json for those dealing with uncommon setups

Emphasis on "for 99.9% of folks we just need standard stuff"

Regarding the specific case of mysqlnd, I think it's de facto covered by the "ext-pdo": "*", we already have

Ah well, the readme for php-ext-depends specifically says that it doesn't try to determine if use of an extension function is in an optional code path.

I went through the previous list real quick and annotated things as best I could:

• runtime use
  • curl (optional, already documented)
  • dom (used by spatie/array-to-xml)
  • filter (in Composer class loader, but I'm not 100% sure when/if this runs)
  • hash
  • iconv (optional; used if present)
  • json (maybe optional?)
  • mbstring (optional; used if present)
  • openssl (basically optional)
  • PDO w/MySQL driver(s)
  • posix (but maybe unused? polyfill)
  • zlib (part of Requests)
• tests only
  • ctype

If my conclusions are reasonable, I'd happily take a stab at updating composer.json with this info. Later I can change this docs PR to point to said updated file for more details.

👍

👍 for this complete list!

Updated this to how it might look when pointing to composer.json. Of course the file doesn't have all the extensions listed yet. I'm working on that. Expect a PR to main repo tomorrow. 😸

And there we go: YOURLS/YOURLS#3339