PHP 버전 호환성 문제 해결하기

PHP 버전 업그레이드나 다운그레이드 시 발생하는 호환성 문제와 해결 방법을 알아보겠습니다. 안정적인 버전 마이그레이션을 위한 실용적인 해결책들을 제시합니다.

1. 버전별 문법 차이 해결

문제: PHP 7.4 → 8.0+ 업그레이드 시 문법 오류

해결책: 호환성 체크 및 조건부 코드 작성

// PHP 8.0+ Named Arguments 호환성
function createUser($name, $email, $age = null, $active = true) {
    // PHP 8.0+에서는 named arguments 사용 가능
    // createUser(name: 'John', email: 'john@example.com', active: false);
    
    return [
        'name' => $name,
        'email' => $email,
        'age' => $age,
        'active' => $active
    ];
}

// PHP 버전별 조건부 실행
if (version_compare(PHP_VERSION, '8.0.0', '>=')) {
    // PHP 8.0+ 전용 코드
    $user = createUser(name: 'John', email: 'john@example.com');
} else {
    // 이전 버전 호환 코드
    $user = createUser('John', 'john@example.com');
}

2. Deprecated 함수 대체

문제: 구버전에서 제거된 함수 사용으로 인한 오류

해결책: 폴백 함수 구현 및 대체 함수 사용

// each() 함수 대체 (PHP 7.2에서 제거)
if (!function_exists('each')) {
    function each(&$array) {
        $key = key($array);
        $result = ($key === null) ? false : [$key, current($array), 'key' => $key, 'value' => current($array)];
        next($array);
        return $result;
    }
}

// create_function() 대체 (PHP 7.2에서 deprecated)
class LegacySupport {
    public static function createFunction($args, $code) {
        if (function_exists('create_function')) {
            return create_function($args, $code);
        } else {
            // 익명 함수로 대체
            return eval("return function($args) { $code };");
        }
    }
    
    // 더 안전한 방법: 미리 정의된 함수 사용
    public static function getCallback($type) {
        $callbacks = [
            'double' => function($x) { return $x * 2; },
            'square' => function($x) { return $x * $x; }
        ];
        
        return $callbacks[$type] ?? function($x) { return $x; };
    }
}

3. 타입 선언 호환성 처리

문제: PHP 7.0+ 타입 힌트와 이전 버전 호환성

해결책: 조건부 타입 선언 및 런타임 검증

// PHP 버전에 따른 조건부 클래스 정의
if (version_compare(PHP_VERSION, '7.0.0', '>=')) {
    class ModernUser {
        private string $name;
        private int $age;
        
        public function __construct(string $name, int $age) {
            $this->name = $name;
            $this->age = $age;
        }
        
        public function getName(): string {
            return $this->name;
        }
    }
} else {
    class ModernUser {
        private $name;
        private $age;
        
        public function __construct($name, $age) {
            // 수동 타입 검증
            if (!is_string($name)) {
                throw new InvalidArgumentException('Name must be string');
            }
            if (!is_int($age)) {
                throw new InvalidArgumentException('Age must be integer');
            }
            
            $this->name = $name;
            $this->age = $age;
        }
        
        public function getName() {
            return $this->name;
        }
    }
}

4. 에러 처리 방식 통일

문제: PHP 7+ 에러/예외 처리 방식 변경

해결책: 통합 에러 핸들러 구현

class CompatibleErrorHandler {
    public static function handleErrors() {
        // PHP 7+ Error와 Exception 통합 처리
        set_error_handler([self::class, 'errorHandler']);
        set_exception_handler([self::class, 'exceptionHandler']);
        
        if (version_compare(PHP_VERSION, '7.0.0', '>=')) {
            // PHP 7+ Fatal Error도 예외로 처리
            register_shutdown_function([self::class, 'fatalErrorHandler']);
        }
    }
    
    public static function errorHandler($severity, $message, $file, $line) {
        if (!(error_reporting() & $severity)) {
            return false;
        }
        
        throw new ErrorException($message, 0, $severity, $file, $line);
    }
    
    public static function exceptionHandler($exception) {
        error_log("Uncaught exception: " . $exception->getMessage());
        
        if (version_compare(PHP_VERSION, '7.0.0', '>=')) {
            // PHP 7+ Throwable 인터페이스 사용
            if ($exception instanceof Error) {
                echo "Fatal Error: " . $exception->getMessage();
            }
        }
        
        echo "Exception: " . $exception->getMessage();
    }
    
    public static function fatalErrorHandler() {
        $error = error_get_last();
        if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR])) {
            self::exceptionHandler(new ErrorException(
                $error['message'], 0, $error['type'], $error['file'], $error['line']
            ));
        }
    }
}

// 에러 핸들러 활성화
CompatibleErrorHandler::handleErrors();

5. 버전 감지 및 기능 체크

문제: 런타임에 사용 가능한 기능 확인 필요

해결책: 포괄적인 호환성 체크 클래스

class PHPCompatibility {
    private static $features = [];
    
    public static function checkFeature($feature) {
        if (isset(self::$features[$feature])) {
            return self::$features[$feature];
        }
        
        switch ($feature) {
            case 'null_coalescing':
                self::$features[$feature] = version_compare(PHP_VERSION, '7.0.0', '>=');
                break;
                
            case 'spaceship_operator':
                self::$features[$feature] = version_compare(PHP_VERSION, '7.0.0', '>=');
                break;
                
            case 'union_types':
                self::$features[$feature] = version_compare(PHP_VERSION, '8.0.0', '>=');
                break;
                
            case 'match_expression':
                self::$features[$feature] = version_compare(PHP_VERSION, '8.0.0', '>=');
                break;
                
            default:
                self::$features[$feature] = false;
        }
        
        return self::$features[$feature];
    }
    
    public static function safeArrayAccess($array, $key, $default = null) {
        // PHP 7.0+ null coalescing operator 사용 가능 시
        if (self::checkFeature('null_coalescing')) {
            return $array[$key] ?? $default;
        } else {
            return isset($array[$key]) ? $array[$key] : $default;
        }
    }
    
    public static function getSystemInfo() {
        return [
            'php_version' => PHP_VERSION,
            'php_major' => PHP_MAJOR_VERSION,
            'php_minor' => PHP_MINOR_VERSION,
            'features' => [
                'null_coalescing' => self::checkFeature('null_coalescing'),
                'spaceship_operator' => self::checkFeature('spaceship_operator'),
                'union_types' => self::checkFeature('union_types'),
                'match_expression' => self::checkFeature('match_expression')
            ]
        ];
    }
}

// 사용 예시
if (PHPCompatibility::checkFeature('null_coalescing')) {
    $value = $_GET['param'] ?? 'default';
} else {
    $value = isset($_GET['param']) ? $_GET['param'] : 'default';
}