COM 및 .Net(Windows) com::__construct

(PHP 4 > 4.1.0, PHP 5, PHP 7, PHP 8)

com::__construct — com class constructor


설명


public com::__construct(
    string $module_name,
    array|string|null $server_name = null,
    int $codepage = CP_ACP,
    string $typelib = ""
)
                

Constructs a new com object.


매개변수

module_name
로드할 구성 요소의 이름을 지정하는 ProgID, 클래스 ID 또는 모니커일 수 있습니다.

ProgID는 일반적으로 응용 프로그램 또는 DLL 이름, 마침표, 개체 이름입니다. 예: Word.Application.

클래스 ID는 주어진 클래스를 고유하게 식별하는 UUID입니다.

모니커는 리소스를 식별하고 로드 방법을 지정하는 URL 체계와 개념이 유사한 특별한 명명 형식입니다. 예를 들어, Word를 로드하고 단어 문서의 전체 경로를 모듈 이름으로 지정하여 단어 문서를 나타내는 개체를 가져오거나 LDAP:를 모니커로 사용하여 LDAP에 대한 ADSI 인터페이스를 사용할 수 있습니다.

server_name
구성 요소를 로드하고 실행해야 하는 DCOM 서버의 이름입니다. null인 경우 개체는 응용 프로그램의 기본값을 사용하여 실행됩니다. 관리자가 다른 컴퓨터에서 시작하도록 응용 프로그램을 구성했을 수 있지만 기본값은 일반적으로 로컬 컴퓨터에서 실행하는 것입니다.

서버에 대해 non-null 값이 지정되면 com.allow_dcom php.ini 옵션이 true로 설정되지 않는 한 PHP는 객체 로드를 거부합니다.

server_name이 배열인 경우 다음 요소를 포함해야 합니다(대소문자 구분!). 모두 선택 사항입니다(사용자 이름과 암호를 함께 지정해야 하지만). 서버 설정을 생략하면 기본 서버가 사용되며(위에서 언급한 대로) 개체의 인스턴스화는 com.allow_dcom php.ini 지시자의 영향을 받지 않습니다.

DCOM server name

key type description
Server string 서버의 이름입니다.
Username string 연결할 사용자 이름입니다.
Password string Username의 암호입니다.
Domain string server의 도메인입니다.
Flags integer 다음 상수 중 하나 이상(논리적으로 함께 OR): CLSCTX_INPROC_SERVER, CLSCTX_INPROC_HANDLER, CLSCTX_LOCAL_SERVER, CLSCTX_REMOTE_SERVER, CLSCTX_SERVERCLSCTX_ALL.

여기에 지정되지 않은 경우 기본값은 Server도 생략하는 경우 CLSCTX_SERVER이고 서버를 지정하는 경우 CLSCTX_REMOTE_SERVER입니다.

이러한 상수의 의미에 대한 자세한 내용은 CoCreateInstance에 대한 Microsoft 설명서를 참조해야 합니다. 일반적으로 사용할 필요가 없습니다.

codepage
문자열을 유니코드 문자열로 또는 그 반대로 변환하는 데 사용되는 코드 페이지를 지정합니다. PHP 문자열이 매개변수로 전달되거나 이 COM 개체의 메서드에서 반환될 때마다 변환이 적용됩니다. 코드 페이지는 고정적이므로 개체에서 반환된 개체 및 변형으로 전파됩니다.

가능한 값은 CP_ACP(시스템 기본 ANSI 코드 페이지 사용 - 이 매개변수가 생략된 경우 기본값), CP_MACCP, CP_OEMCP, CP_SYMBOL, CP_THREAD_ACP(현재 실행 중인 스레드에 대해 설정된 코드 페이지/로케일 사용), CP_UTF7CP_UTF8입니다.

주어진 코드 페이지에 대한 번호를 사용할 수도 있습니다. 코드 페이지 및 해당 숫자 값에 대한 자세한 내용은 Microsoft 설명서를 참조하십시오.