PHP5.3のクラスエイリアシングを使った型下位互換技術

Entity.php

<?php

namespace XCore\Entity;

class User
{
	// 元XoopsUserクラス
}

class Module
{
	// 元XoopsModuleクラス
}

class Group
{
	// 元XoopsGroupクラス
}

IDE-sutbs.php

<?php

// Stubs for IDEs
/**
 * @deprecated
 */
class XoopsUser extends \XCore\Entity\User {}

/**
 * @deprecated
 */
class XoopsModule extends \XCore\Entity\Module {}

/**
 * @deprecated
 */
class XoopsGroup extends \XCore\Entity\Group {}

LegacySupportPreload.php

<?php

// Supports for legacy modules, legacy component or legacy library
class_alias('\XCore\Entity\User', 'XoopsUser');
class_alias('\XCore\Entity\Module', 'XoopsModule');
class_alias('\XCore\Entity\Group', 'XoopsGroup');

LegacySupportPreloadTest.php

<?php

require 'Entity.php';
require 'LegacySupportPreload.php';

use XCore\Entity\User;
use XCore\Entity\Module;
use XCore\Entity\Group;

// Test: `instanceof`
var_dump(new User() instanceof XoopsUser); // true

// Test: Type-hinting
function accept_user_object(XoopsUser $xoopsUser) { /*...*/ }
accept_user_object(new User()); // no exceptions

// Test: `is_a()`
var_dump(is_a(new User(), 'XoopsUser')); // true

• PhpStromなどのIDEの静的解析は IDE-sutbs.php をプロジェクトに置いて、うまくだます。
• XoopsUser などに依存しているライブラリやコンポーネントは LegacySupportPreload.php を置くと動くようになる。 LegacySupportPreload.php を削除すれば、型の下位互換を簡単に破棄できる。