phpstorm-phpcs

#!/usr/bin/env php
<?php

declare(strict_types=1);

if (\PHP_VERSION_ID < 80000) {
  function str_starts_with(string $haystack, string $needle): bool {
    return 0 === \strncmp($haystack, $needle, \strlen($needle));
  }
}

/**
 * Possible names of config file. Ordered by priority.
 */
const CONFIG_FILENAMES = [
  'phpcs.xml',
  'phpcs.xml.dist',
];

/**
 * Name of tool to run.
 */
const TOOL_NAME = 'phpcs';

/**
 * Paths to search for tool relative to directory of config dir starting with
 * "/". Ordered by priority.
 */
const RELATIVE_TOOL_PATHS = [
  '/tools/phpcs/vendor/bin/phpcs',
  '/vendor/bin/phpcs',
];

/**
 * Absolute path to tool, name of command in PATH, or NULL. Used if tool could
 * not be found in relative paths.
 */
const TOOL_FALLBACK = TOOL_NAME;

function findOriginalFile(array $argv, string $projectDir): string {
  array_shift($argv);
  foreach ($argv as $arg) {
    if (!\str_starts_with($arg, '-')) {
      // Previous PhpStorm versions put the file to analyze below /tmp using the
      // same directory structure as in the project directory.
      if (1 !== \preg_match('#^/tmp/[^/]+(?<file>.+)$#', $arg, $matches)) {
        throw new \RuntimeException('Could not determine original file from ' . $arg);
      }

      return $projectDir . $matches['file'];
    }

    // Recent PhpStorm versions pass the file via STDIN and make use of the --stdin-path option.
    if (\str_starts_with($arg, '--stdin-path=')) {
      return substr($arg, 13);
    }
  }

  throw new \RuntimeException('Could not determine original file');
}

function buildArgs(array $argv, int $argc, string $configFile): array {
  for ($i = 1; $i < $argc; ++$i) {
    if (\str_starts_with($argv[$i], '--standard=')) {
      $argv[$i] = '--standard=' . $configFile;

      return $argv;
    }
  }

  throw new \RuntimeException('Argument "--standard=" not found');
}

function findConfigFile(string $origFile, string $projectDir): string {
  $configDir = \dirname($origFile);
  $projectParentDir = dirname($projectDir);
  while ($configDir !== $projectParentDir && $configDir !== '/') {
    foreach (CONFIG_FILENAMES as $configFilename) {
      $configFile = $configDir . '/' . $configFilename;
      if (\file_exists($configFile)) {
        return $configFile;
      }
    }

    $configDir = \dirname($configDir);
  }

  \fprintf(STDERR, "No configuration file found for $origFile\n");
  exit(0);
}

function findTool(string $configDir): string {
  foreach (RELATIVE_TOOL_PATHS as $path) {
    $tool = $configDir . $path;
    if (\file_exists($tool)) {
      return $tool;
    }
  }

  $command = locateCommand(TOOL_FALLBACK);
  if (NULL !== $command) {
    return $command;
  }

  throw new \RuntimeException(TOOL_NAME . ' not found');
}

function locateCommand(?string $command): ?string {
  if (NULL === $command) {
    return NULL;
  }

  return \exec('which ' . $command) ?: NULL;
}

$projectDir = \getcwd();
$origFile = findOriginalFile($argv, $projectDir);
$configFile = findConfigFile($origFile, $projectDir);
$configDir = \dirname($configFile);
$argv[0] = findTool($configDir);
$argv = buildArgs($argv, $argc, $configFile);

\chdir($configDir);
\putenv('XDEBUG_MODE=off');
\passthru(PHP_BINARY . ' ' . \implode(' ', $argv), $exitCode);
exit($exitCode);