トップページ　→関数リファレンス　→データベース関連　→ベンダー固有のモジュール　→OCI8　→OCI8 関数

関数・クラス解説

oci_set_client_identifier

version:PHP 5 >= 5.3.2, PHP 7, PECL OCI8 (公式)

クライアント識別子を設定します

公式リファレンス

書式

oci_set_client_identifier ( resource $connection , string $client_identifier ) : bool

説明

同一のデータベース・ユーザーとして認証するライトウェイト・アプリケーションのユーザーを識別するために、様々なデータベースコンポーネントによって使用されるクライアント識別子を設定します。

PHP からデータベースへの次の「ラウンドトリップ」が起きると、クライアント識別子がデータベースに登録されます。これは一般的にSQLステートメントが実行されるときに起こります。

SELECT SYS_CONTEXT('USERENV','CLIENT_IDENTIFIER') FROM DUAL などとして、クライアント識別子を後に問い合わせることができます。 V$SESSION のようなデータベース管理ビューにも同じ値が含まれています。それは DBMS_MONITOR.CLIENT_ID_TRACE_ENABLE と一緒に追跡のために使われることができます。それは監査のために使われることができます。

この関数で設定した値は、同じ持続的接続を使っている複数のページリクエストにまたがって保持される可能性があります。

パラメータ

connection: oci_connect()、oci_pconnect()あるいは oci_new_connect() が返す Oracle 接続 ID。
client_identifier: ユーザーが選んだ、長さが最高64バイトの文字列。

返値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

注意

警告

データベースとのやりとりに関するメモ

OCI8 関数の中には、データベースとのやりとりを伴わないものもあります。たとえば、結果のキャッシングが有効になっている場合、クエリを実行してもデータベースとのやりとりを行わない可能性があります。

サンプル

例1 クライアント識別子をアプリケーションのユーザーに設定する 


// アプリケーションのユーザーログイン名を検索
session_start();
$un = my_validate_session($_SESSION['username']);
$c = oci_connect('myschema', 'welcome', 'localhost/XE');

// そのユーザーが誰であるか Oracle に通知
oci_set_client_identifier($c, $un);

// データベースへの次の「ラウンドトリップ」がその識別子を背負うでしょう
$s = oci_parse($c, 'select mydata from mytable');
oci_execute($s);

// ...

参考

oci_set_module_name() - モジュール名を設定します

oci_set_action() - アクション名を設定します

oci_set_client_info() - クライアント情報を設定する

oci_set_db_operation() - Sets the database operation

ワード検索

※入力キーワードが、関数名・説明文・タグに含まれるものを検索

関数名アルファベット別

A	B	C	D	E	F	G	H	I	J
K	L	M	N	O	P	Q	R	S	T
U	V	W	X	Y	Z	_

最終更新一覧

●stristr
　大文字小文字を区別せず文字列を検索し、ヒット箇所以降（あるいは以前）の文字列を返却

●stripslashes
　バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

●stripos
　大文字小文字を区別せずに文字列が最初に現れる位置を取得する

●stripcslashes
　addcslashes() でクォートされた文字列をアンクォートする

●strip_tags
　文字列から HTML と PHP のタグを除去して返却

●strcspn
　指定した文字が最初に現れる位置を調べる

●strcoll
　ロケールに基づいて2つの文字列を比較し同じか（あるいは大小）を判定する

●strcmp
　2つの文字列を比較し同じか（あるいは大小）を判定する

●strchr
　strstr() のエイリアス

●strcasecmp
　2つの文字列を比較（大文字小文字を区別せず同じとみなす）

カテゴリー一覧

PHP の振る舞いの変更
 音声フォーマットの操作
 認証サービス
 コマンドライン関連
 圧縮およびアーカイブ
 暗号
 データベース関連
 日付および時刻関連
 ファイルシステム
 自然言語および文字エンコーディング
 画像処理および作成
 メール関連
 数学
 テキスト以外の MIME 型
 プロセス制御
 その他の基本モジュール
 その他のサービス
 検索エンジン用の拡張モジュール
 サーバー固有のモジュール
 セッション関連
 テキスト処理
 変数・データ型関連
 ウェブサービス
 Windows 用のモジュール
 XML 操作
 GUI用の拡張モジュール