`Path::join()` is not documented

[SergeyTsalkov]

Path::join() is a very useful method because it lets you replace ugly string concatenation for paths with cleaner code. However, it is not documented under https://symfony.com/doc/current/components/filesystem.html#path-manipulation-utilities

[OskarStark]

WDYT about

• [Filesystem] Document the Path::join() method #21164

[SergeyTsalkov]

Mostly looks good! One concern, you give this example:

echo Path::join('/var/www', '/etc', 'config.ini');
// => /etc/config.ini

This doesn't behave the way you describe for me. I tested with PHP 8.4.8 and symfony/filesystem 7.3.0. My code:

<?php
require_once __DIR__ . '/vendor/autoload.php';
use Symfony\Component\Filesystem\Path;

var_dump(Path::join('/var/www', '/etc', 'config.ini'));

and results:

string(23) "/var/www/etc/config.ini"

Not sure if the code is wrong, or the documentation, as I could see the argument for either behavior.

[OskarStark]

You are right, updated! Thanks