[LOG] Improve logs wording, add classname in log files

[M0rgan01]

Questions	Answers
Description?	Improve logs wording, add classname in log files
Type?	improvement
BC breaks?	no
Deprecations?	no
Fixed ticket?	-
Sponsor company	-
How to test?	-

[ga-devfront]

A small typo otherwise everything is good, thank you!

[M0rgan01]

@Quetzacoalt91

With classname (with dev branch) in seconde

1. 72.21
2. 67.57
3. 68.83
4. 69.28
5. 68.72
6. 68.43
7. 69.23
8. 70.80
9. 68.67
10. 73.84

Average: 69.76

With classname in seconde

1. 68.54
2. 71.46
3. 67.55
4. 68.26
5. 70.99
6. 74.65
7. 69.34
8. 71.15
9. 68.11
10. 69.54

Average: 69.96

test conditions: I use time command with the update:start command. 1.7.7.0 to 8.2.0 with https://github.com/PrestaShop/SeamlessUpgradeToolbox

Total logs for 1 update: 30 000
PHP version: 7.4

[Quetzacoalt91]

I've created a task that only calls the logger in a reasonable way:

class Test extends AbstractTask
{
    const TASK_TYPE = TaskType::TASK_TYPE_UPDATE;

    /**
     * @throws Exception
     */
    public function run(): int
    {
        for ($i = 0 ; $i < 450 ; ++$i) {
            $this->logger->info($this->translator->trans(
                'Logger called'
            ));
        }

        $this->next = TaskName::TASK_UPDATE_COMPLETE;

        return ExitCode::SUCCESS;
    }
}

It takes 12 on the dev branch and 17 ms on this PR, which seems still acceptable.

When we profile it, getting the caller is taking ~13% of the script execution time and is flagged by Blackfire as an intensive node.
https://blackfire.io/profiles/77d55665-82d3-436d-a69e-bfdd7c9a0229/graph

And when focusing on this method on particular:

I'll suggest a small improvement on the subclass check, and this part should be unit tested to be future-proof.

[Quetzacoalt91]

Suggested change

	$trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
	foreach ($trace as $frame) {
	if (
	isset($frame['class']) &&
	!is_subclass_of($frame['class'], self::class) &&
	$frame['class'] !== self::class
	) {
	// We don't need the whole stack. The 5th level is enough to get
	// the called of the logger but we keep a buffer in case it goes deeper.
	$trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 8);
	foreach ($trace as $frame) {
	if (
	isset($frame['class']) &&
	strpos($frame['class'], __NAMESPACE__) === false
	) {

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[Quetzacoalt91]

2025-01-08-111321-backup.txt

2025-01-08-110915-update.txt

Caller class is properly reported in the log file.