PHP: полный мануал с примерами, функциями и ООП

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;
try {
    $config=f160Config();$service=f160Service();$runtime=f160Runtime($service);

    $loginAs = static function(string $database,string $user,string $password): array {
        $connection=f160ConnectUser($database,$user,$password);
        try {
            $rows=f160Read($connection,'SELECT TRIM(CURRENT_USER) AS "login" FROM RDB$DATABASE');
            return ['connected'=>true,'identity_matches'=>($rows[0]['login']??null)===$user];
        } finally { f160Close($connection); }
    };
    $tryLogin = static function(string $database,string $user,string $password): array {
        $call=f160TryConnectUser($database,$user,$password);
        $connection=$call['value'];$call['value']=null;
        $connected=is_resource($connection);
        if($connected)f160Close($connection);
        return ['connected'=>$connected,'warning'=>$call['warning'],'code'=>$call['code'],
            'message_present'=>$call['message_present']];
    };

    $database=f160CreateDatabase($service,$owned,'user_create');
    $user=f160NewUser($owned,'import');
    $password=f160Password();
    $action=f160AddUser($service,$user,$password);
    $identity=$loginAs($database,$user,$password);
    $db=f160Connect($database);
    $profile=f160UserProfile($db,$user);f160Commit($db);
    $rows=[['Сервисное создание завершено',$action['completed']],
        ['Новый TCP-вход выполнен',$identity['connected']],
        ['CURRENT_USER совпадает с новым логином',$identity['identity_matches']],
        ['Учётная запись найдена в security database',$profile!==null]];
    $checks=['create_completed'=>$action['completed'],'fresh_login'=>$identity['connected'],
        'identity_matches'=>$identity['identity_matches'],'profile_exists'=>$profile!==null];
    $observations=['transport'=>'tcp_loopback_authenticated','account'=>$identity,
        'profile_found'=>$profile!==null,'service_action'=>$action];

} finally {
    if(is_resource($db)){f160Close($db);}
    if(is_resource($service)){f160Detach($service);}
    $removed=f160Cleanup($owned);
}

f160Report('fb160-user-create','Создать отдельную учётную запись и действительно войти',$rows,$checks,$observations,$runtime,$owned,$removed);

Сервисное создание завершено — да
Новый TCP-вход выполнен — да
CURRENT_USER совпадает с новым логином — да
Учётная запись найдена в security database — да

Самостоятельный CLI-пример работает с одной собственной базой и случайными учебными пользователями отдельного TCP-сервера. Полный код, lab.php и README приложены. После завершения откройте result.html; result.json содержит те же результаты и наблюдения без паролей.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;
try {
    $config=f160Config();$service=f160Service();$runtime=f160Runtime($service);

    $loginAs = static function(string $database,string $user,string $password): array {
        $connection=f160ConnectUser($database,$user,$password);
        try {
            $rows=f160Read($connection,'SELECT TRIM(CURRENT_USER) AS "login" FROM RDB$DATABASE');
            return ['connected'=>true,'identity_matches'=>($rows[0]['login']??null)===$user];
        } finally { f160Close($connection); }
    };
    $tryLogin = static function(string $database,string $user,string $password): array {
        $call=f160TryConnectUser($database,$user,$password);
        $connection=$call['value'];$call['value']=null;
        $connected=is_resource($connection);
        if($connected)f160Close($connection);
        return ['connected'=>$connected,'warning'=>$call['warning'],'code'=>$call['code'],
            'message_present'=>$call['message_present']];
    };

    $database=f160CreateDatabase($service,$owned,'user_profile');
    $user=f160NewUser($owned,'operator');$password=f160Password();
    $action=f160AddUser($service,$user,$password,['Anna','M','Reader']);
    $identity=$loginAs($database,$user,$password);
    $db=f160Connect($database);
    $profile=f160UserProfile($db,$user);f160Commit($db);
    $rows=[['Имя',$profile['first']??null],['Среднее имя',$profile['middle']??null],
        ['Фамилия',$profile['last']??null],['Новый вход под этой учётной записью',$identity['identity_matches']]];
    $checks=['profile_name'=>($profile['first']??null)==='Anna',
        'profile_middle'=>($profile['middle']??null)==='M',
        'profile_last'=>($profile['last']??null)==='Reader','profile_login'=>$identity['identity_matches']];
    $observations=['profile'=>$profile,'account'=>$identity,'service_action'=>$action];

} finally {
    if(is_resource($db)){f160Close($db);}
    if(is_resource($service)){f160Detach($service);}
    $removed=f160Cleanup($owned);
}

f160Report('fb160-user-profile','Создать оператора с именем и отличить профиль от прав',$rows,$checks,$observations,$runtime,$owned,$removed);

Имя — Anna
Среднее имя — M
Фамилия — Reader
Новый вход под этой учётной записью — да

Самостоятельный CLI-пример работает с одной собственной базой и случайными учебными пользователями отдельного TCP-сервера. Полный код, lab.php и README приложены. После завершения откройте result.html; result.json содержит те же результаты и наблюдения без паролей.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;
try {
    $config=f160Config();$service=f160Service();$runtime=f160Runtime($service);

    $loginAs = static function(string $database,string $user,string $password): array {
        $connection=f160ConnectUser($database,$user,$password);
        try {
            $rows=f160Read($connection,'SELECT TRIM(CURRENT_USER) AS "login" FROM RDB$DATABASE');
            return ['connected'=>true,'identity_matches'=>($rows[0]['login']??null)===$user];
        } finally { f160Close($connection); }
    };
    $tryLogin = static function(string $database,string $user,string $password): array {
        $call=f160TryConnectUser($database,$user,$password);
        $connection=$call['value'];$call['value']=null;
        $connected=is_resource($connection);
        if($connected)f160Close($connection);
        return ['connected'=>$connected,'warning'=>$call['warning'],'code'=>$call['code'],
            'message_present'=>$call['message_present']];
    };

    $authChildrenStopped=true;
    $authenticateFresh=static function(string $phase,string $database,string $user,string $password) use (&$authChildrenStopped): array {
        if(!in_array($phase,['before','old','new'],true))throw new InvalidArgumentException('Неизвестный этап проверки.');
        $state=&f160State();f160UserIdentifier($user);
        if(!isset($state['databases'][$database])||isset($state['removed'][$database])||!is_file(f160Path($database)))
            throw new RuntimeException('Нет собственной базы для проверки входа.');
        $configured=getenv('PHPMAN_INTERBASE_EXTENSION');
        $extension=is_string($configured)&&$configured!==''?$configured:dirname(PHP_BINARY).'/ext/php_interbase.dll';
        $extension=realpath($extension);
        if($extension===false||!is_file($extension))throw new RuntimeException('Укажите DLL interbase 3.0.1 через PHPMAN_INTERBASE_EXTENSION; см. README.');
        $command=[PHP_BINARY,'-n','-d','extension='.$extension,__DIR__.'/auth-child.php'];
        $environment=getenv();unset($environment['PHPMAN_FIREBIRD_PASSWORD']);
        $log='auth-'.$phase;$stdoutFile=$log.'.stdout.log';$stderrFile=$log.'.stderr.log';
        $record=['schema'=>'aen-firebird160-auth-process-v1','phase'=>$phase,'started'=>false,'stopped'=>false,
            'final_running'=>false,'timed_out'=>false,'pid'=>null,'exit_code'=>null,'proc_close_return'=>null,
            'automatic_retries'=>0,'status'=>'failed','response_sha256'=>null,'stdout_file'=>$stdoutFile,'stderr_file'=>$stderrFile];
        $process=null;$pipes=[];$exit=null;$stopped=false;static $unreaped=[];
        try{
            $process=proc_open($command,[0=>['pipe','r'],1=>['file',__DIR__.'/'.$stdoutFile,'w'],
                2=>['file',__DIR__.'/'.$stderrFile,'w']],$pipes,__DIR__,$environment,
                ['bypass_shell'=>true,'create_no_window'=>true]);
            if(!is_resource($process))throw new RuntimeException('Проверка нового входа не запущена.');
            $authChildrenStopped=false;
            $status=proc_get_status($process);$record['started']=true;$record['pid']=(int)$status['pid'];
            $request=json_encode(['database'=>$database,'user'=>$user,'password'=>$password],JSON_THROW_ON_ERROR);
            $written=fwrite($pipes[0],$request);fclose($pipes[0]);$pipes=[];
            if($written!==strlen($request))throw new RuntimeException('Параметры нового входа не переданы полностью.');
            unset($request,$password);
            $deadline=microtime(true)+8;
            do{
                if(!$status['running']){$exit=(int)$status['exitcode'];$stopped=true;break;}
                usleep(50000);$status=proc_get_status($process);
            }while(microtime(true)<$deadline);
            if(!$stopped){$record['timed_out']=true;throw new RuntimeException('Проверка нового входа превысила восемь секунд.');}
            $body=file_get_contents(__DIR__.'/'.$stdoutFile);
            $reply=$body===false?null:json_decode($body,true,512,JSON_THROW_ON_ERROR);
            if($exit!==0||!is_array($reply)||!is_bool($reply['connected']??null)||!is_bool($reply['identity_matches']??null)
                ||!is_int($reply['code']??null)||!is_bool($reply['warning']??null)||!is_bool($reply['message_present']??null))
                throw new RuntimeException('Нет корректного результата отдельного входа.');
            if($reply['connected']&&(!is_int($reply['attachment_id']??null)||($reply['network_protocol']??null)!=='TCPv4'))
                throw new RuntimeException('Нет TCP attachment нового входа.');
            $record['response_sha256']=hash('sha256',(string)$body);$record['status']='passed';
            return $reply;
        }finally{
            foreach($pipes as $pipe)if(is_resource($pipe))fclose($pipe);
            if(is_resource($process)){
                $status=proc_get_status($process);
                if($status['running']){
                    proc_terminate($process);$deadline=microtime(true)+2;
                    do{$status=proc_get_status($process);if(!$status['running'])break;usleep(50000);}while(microtime(true)<$deadline);
                }
                $stopped=!$status['running'];$record['stopped']=$stopped;$record['final_running']=$status['running'];
                $authChildrenStopped=$stopped;
                if($exit===null&&!$status['running'])$exit=(int)$status['exitcode'];$record['exit_code']=$exit;
                if($stopped)$record['proc_close_return']=proc_close($process);
                else{$record['proc_close_return']=null;$unreaped[]=$process;$record['status']='failed';}
                $process=null;
            }
            file_put_contents(__DIR__.'/'.$log.'-process.json',json_encode($record,JSON_PRETTY_PRINT|JSON_UNESCAPED_SLASHES|JSON_THROW_ON_ERROR)."\n");
        }
    };

    $database=f160CreateDatabase($service,$owned,'password');
    $user=f160NewUser($owned,'integration');
    $oldPassword=f160Password();$newPassword=f160Password();
    f160AddUser($service,$user,$oldPassword,['Anna','M','Reader']);
    $before=$authenticateFresh('before',$database,$user,$oldPassword);
    $action=f160ModifyUser($service,$user,$newPassword);
    $oldAttempt=$authenticateFresh('old',$database,$user,$oldPassword);
    $after=$authenticateFresh('new',$database,$user,$newPassword);
    $db=f160Connect($database);$profile=f160UserProfile($db,$user);f160Commit($db);
    $preserved=($profile['first']??null)==='Anna'&&($profile['middle']??null)==='M'&&($profile['last']??null)==='Reader';
    $rows=[['До изменения старый пароль работал',$before['identity_matches']],
        ['После изменения старый пароль отклонён',!$oldAttempt['connected']],
        ['Новый пароль принят',$after['identity_matches']],['Не переданные поля профиля сохранены',$preserved]];
    $checks=['before_login'=>$before['identity_matches'],'old_password_rejected'=>!$oldAttempt['connected'],
        'rejection_diagnosed'=>$oldAttempt['code']===-902&&$oldAttempt['warning']&&$oldAttempt['message_present'],
        'new_password_accepted'=>$after['identity_matches'],'omitted_profile_preserved'=>$preserved,
        'separate_tcp_attachments'=>$before['attachment_id']!==$after['attachment_id']
            &&$before['network_protocol']==='TCPv4'&&$after['network_protocol']==='TCPv4'];
    $observations=['before'=>$before,'old_password_attempt'=>$oldAttempt,'after'=>$after,
        'profile'=>$profile,'service_action'=>$action,'authentication_checks'=>['before'=>$before,'old'=>$oldAttempt,'new'=>$after]];

} finally {
    if(is_resource($db)){f160Close($db);}
    if(is_resource($service)){f160Detach($service);}
    if(isset($authChildrenStopped)&&!$authChildrenStopped){throw new RuntimeException("Проверка входа ещё работает; удаление базы запрещено.");}
    $removed=f160Cleanup($owned);
}

f160Report('fb160-user-password','Сменить пароль и проверить оба варианта новым входом',$rows,$checks,$observations,$runtime,$owned,$removed);

До изменения старый пароль работал — да
После изменения старый пароль отклонён — да
Новый пароль принят — да
Не переданные поля профиля сохранены — да

Самостоятельный CLI-пример работает с одной собственной базой и случайными учебными пользователями отдельного TCP-сервера. Полный код, lab.php и README приложены. После завершения откройте result.html; result.json содержит те же результаты и наблюдения без паролей.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;
try {
    $config=f160Config();$service=f160Service();$runtime=f160Runtime($service);

    $loginAs = static function(string $database,string $user,string $password): array {
        $connection=f160ConnectUser($database,$user,$password);
        try {
            $rows=f160Read($connection,'SELECT TRIM(CURRENT_USER) AS "login" FROM RDB$DATABASE');
            return ['connected'=>true,'identity_matches'=>($rows[0]['login']??null)===$user];
        } finally { f160Close($connection); }
    };
    $tryLogin = static function(string $database,string $user,string $password): array {
        $call=f160TryConnectUser($database,$user,$password);
        $connection=$call['value'];$call['value']=null;
        $connected=is_resource($connection);
        if($connected)f160Close($connection);
        return ['connected'=>$connected,'warning'=>$call['warning'],'code'=>$call['code'],
            'message_present'=>$call['message_present']];
    };

    $database=f160CreateDatabase($service,$owned,'profile_edit');
    $user=f160NewUser($owned,'profile_edit');$password=f160Password();
    f160AddUser($service,$user,$password,['Anna','M','Reader']);
    $db=f160Connect($database);
    $before=f160UserProfile($db,$user);f160Commit($db);
    $firstAction=f160ModifyUser($service,$user,$password,['Ann']);
    $afterFirst=f160UserProfile($db,$user);f160Commit($db);
    $emptyAction=f160ModifyUser($service,$user,$password,['Ann','']);
    $afterEmpty=f160UserProfile($db,$user);f160Commit($db);
    $identity=$loginAs($database,$user,$password);
    $omittedPreserved=($afterFirst['middle']??null)==='M'&&($afterFirst['last']??null)==='Reader';
    $emptyString=array_key_exists('middle',$afterEmpty)&&$afterEmpty['middle']==='';
    $middleLabel=$emptyString?'"" (пустая строка)':'другое значение';
    $rows=[['Исходное имя',$before['first']??null],['Новое имя',$afterFirst['first']??null],
        ['Пропущенные middle/last сохранены',$omittedPreserved],
        ['После явного пустого middle',$middleLabel],['Фамилия после обоих изменений',$afterEmpty['last']??null],
        ['Вход с тем же паролем работает',$identity['identity_matches']]];
    $checks=['initial_profile'=>($before['first']??null)==='Anna'&&($before['middle']??null)==='M',
        'first_changed'=>($afterFirst['first']??null)==='Ann','omitted_fields_preserved'=>$omittedPreserved,
        'empty_is_string'=>$emptyString,'last_preserved'=>($afterEmpty['last']??null)==='Reader',
        'password_still_valid'=>$identity['identity_matches']];
    $observations=['before'=>$before,'after_first_only'=>$afterFirst,'after_explicit_empty'=>$afterEmpty,
        'account'=>$identity,'service_actions'=>[$firstAction,$emptyAction]];

} finally {
    if(is_resource($db)){f160Close($db);}
    if(is_resource($service)){f160Detach($service);}
    $removed=f160Cleanup($owned);
}

f160Report('fb160-user-profile-edit','Пропустить поле или очистить его: два разных изменения',$rows,$checks,$observations,$runtime,$owned,$removed);

Исходное имя — Anna
Новое имя — Ann
Пропущенные middle/last сохранены — да
После явного пустого middle — "" (пустая строка)
Фамилия после обоих изменений — Reader
Вход с тем же паролем работает — да

Самостоятельный CLI-пример работает с одной собственной базой и случайными учебными пользователями отдельного TCP-сервера. Полный код, lab.php и README приложены. После завершения откройте result.html; result.json содержит те же результаты и наблюдения без паролей.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;
try {
    $config=f160Config();$service=f160Service();$runtime=f160Runtime($service);

    $loginAs = static function(string $database,string $user,string $password): array {
        $connection=f160ConnectUser($database,$user,$password);
        try {
            $rows=f160Read($connection,'SELECT TRIM(CURRENT_USER) AS "login" FROM RDB$DATABASE');
            return ['connected'=>true,'identity_matches'=>($rows[0]['login']??null)===$user];
        } finally { f160Close($connection); }
    };
    $tryLogin = static function(string $database,string $user,string $password): array {
        $call=f160TryConnectUser($database,$user,$password);
        $connection=$call['value'];$call['value']=null;
        $connected=is_resource($connection);
        if($connected)f160Close($connection);
        return ['connected'=>$connected,'warning'=>$call['warning'],'code'=>$call['code'],
            'message_present'=>$call['message_present']];
    };

    $database=f160CreateDatabase($service,$owned,'user_delete');
    $user=f160NewUser($owned,'temporary');$password=f160Password();
    f160AddUser($service,$user,$password,['Anna']);
    $before=$loginAs($database,$user,$password);
    // Внешние SQL-подключения закрыты; helper может проверить SEC$USERS своим соединением.
    $action=f160DeleteUser($service,$user);
    $attempt=$tryLogin($database,$user,$password);
    $db=f160Connect($database);$profile=f160UserProfile($db,$user);f160Commit($db);
    $rows=[['До удаления вход работал',$before['identity_matches']],
        ['Удаление завершено',$action['completed']],['Профиль отсутствует',$profile===null],
        ['Новый вход отклонён',!$attempt['connected']]];
    $checks=['before_delete_login'=>$before['identity_matches'],'delete_completed'=>$action['completed'],
        'profile_absent'=>$profile===null,'deleted_login_rejected'=>!$attempt['connected'],
        'delete_rejection_diagnosed'=>$attempt['code']!==0&&$attempt['message_present']];
    $observations=['before'=>$before,'profile_after'=>$profile,'login_after'=>$attempt,'service_action'=>$action];

} finally {
    if(is_resource($db)){f160Close($db);}
    if(is_resource($service)){f160Detach($service);}
    $removed=f160Cleanup($owned);
}

f160Report('fb160-user-delete','Удалить временный доступ и подтвердить отказ нового входа',$rows,$checks,$observations,$runtime,$owned,$removed);

До удаления вход работал — да
Удаление завершено — да
Профиль отсутствует — да
Новый вход отклонён — да

Самостоятельный CLI-пример работает с одной собственной базой и случайными учебными пользователями отдельного TCP-сервера. Полный код, lab.php и README приложены. После завершения откройте result.html; result.json содержит те же результаты и наблюдения без паролей.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;
try {
    $config=f160Config();$service=f160Service();$runtime=f160Runtime($service);

    $loginAs = static function(string $database,string $user,string $password): array {
        $connection=f160ConnectUser($database,$user,$password);
        try {
            $rows=f160Read($connection,'SELECT TRIM(CURRENT_USER) AS "login" FROM RDB$DATABASE');
            return ['connected'=>true,'identity_matches'=>($rows[0]['login']??null)===$user];
        } finally { f160Close($connection); }
    };
    $tryLogin = static function(string $database,string $user,string $password): array {
        $call=f160TryConnectUser($database,$user,$password);
        $connection=$call['value'];$call['value']=null;
        $connected=is_resource($connection);
        if($connected)f160Close($connection);
        return ['connected'=>$connected,'warning'=>$call['warning'],'code'=>$call['code'],
            'message_present'=>$call['message_present']];
    };

    $database=f160CreateDatabase($service,$owned,'user_replace');
    $previous=f160NewUser($owned,'previous');$replacement=f160NewUser($owned,'replacement');
    $previousPassword=f160Password();$replacementPassword=f160Password();
    f160AddUser($service,$previous,$previousPassword,['Anna']);
    f160AddUser($service,$replacement,$replacementPassword,['Boris']);
    $db=f160Connect($database);
    foreach([$previous,$replacement] as $user){
        // Identifier разрешён только для зарегистрированного случайного учебного имени.
        $identifier=f160UserIdentifier($user);
        f160Command($db,'GRANT SELECT ON LAB_ITEMS TO USER "'.$identifier.'"');
    }
    f160Commit($db);f160Close($db);
    $readCatalog=static function(string $database,string $user,string $password): array {
        $connection=f160ConnectUser($database,$user,$password);
        try{return f160Read($connection,'SELECT TITLE AS "title", QTY AS "qty" FROM LAB_ITEMS WHERE QTY>0 ORDER BY ID ROWS 1');}
        finally{f160Close($connection);}
    };
    $before=$readCatalog($database,$previous,$previousPassword);
    f160DeleteUser($service,$previous);
    $oldAttempt=$tryLogin($database,$previous,$previousPassword);
    $after=$readCatalog($database,$replacement,$replacementPassword);
    $db=f160Connect($database);$oldProfile=f160UserProfile($db,$previous);f160Commit($db);
    $newProfile=f160UserProfile($db,$replacement);f160Commit($db);
    $expected=[['title'=>'Cable','qty'=>3]];
    $rows=[['Прежний оператор читал каталог',$before===$expected],
        ['После удаления прежний вход отклонён',!$oldAttempt['connected']],
        ['Новый оператор читает товар',$after[0]['title']??null],['Доступное количество',$after[0]['qty']??null],
        ['Сохранён независимый профиль замены',($newProfile['first']??null)==='Boris']];
    $checks=['previous_catalog_read'=>$before===$expected,'previous_login_closed'=>!$oldAttempt['connected'],
        'previous_profile_removed'=>$oldProfile===null,'replacement_catalog_read'=>$after===$expected,
        'replacement_profile_preserved'=>($newProfile['first']??null)==='Boris'];
    $observations=['before_catalog'=>$before,'previous_login_after'=>$oldAttempt,
        'replacement_catalog'=>$after,'previous_profile_after'=>$oldProfile,'replacement_profile'=>$newProfile];

} finally {
    if(is_resource($db)){f160Close($db);}
    if(is_resource($service)){f160Detach($service);}
    $removed=f160Cleanup($owned);
}

f160Report('fb160-user-replacement','Передать чтение каталога другому оператору',$rows,$checks,$observations,$runtime,$owned,$removed);

Прежний оператор читал каталог — да
После удаления прежний вход отклонён — да
Новый оператор читает товар — Cable
Доступное количество — 3
Сохранён независимый профиль замены — да

Самостоятельный CLI-пример работает с одной собственной базой и случайными учебными пользователями отдельного TCP-сервера. Полный код, lab.php и README приложены. После завершения откройте result.html; result.json содержит те же результаты и наблюдения без паролей.