MochiuWiki : SUSE, EC, PCB - 利用者の投稿記録 [ja]

インストール - Nginx(RHEL)

2019-12-07T17:02:01Z

192.168.1.17: ページの作成:「== 概要 == == リポジトリの設定 == リポジトリを追加するので、nginx.repoファイルを作成する。 sudo nano /etc/yum.repos.d/nginx.repo <…」

== 概要 ==

== リポジトリの設定 ==
リポジトリを追加するので、nginx.repoファイルを作成する。 
sudo nano /etc/yum.repos.d/nginx.repo
 
上記で作成したnginx.repoファイルに以下の内容を書き込み保存する。 
[nginx]
name=nginx repo
baseurl=http://nginx.org/packages/mainline/centos/7/$basearch/
gpgcheck=0
enabled=1
 

== インストールと起動 ==
以下のコマンドを入力して、Nginxをインストールする。 
sudo yum install nginx
 
インストールしたNginxのバージョンを確認する。 
nginx -v
 
自動起動設定とNginxの起動を行う。 
sudo systemctl enable nginx
sudo systemctl start nginx
 
デフォルトページの表示の確認をする。 
http://CentOSのコンピュータ名/
 
上記のindex.htmlのデフォルトのパス 
/usr/share/nginx/html/index.html
Nginxの設定ファイルのパス 
/etc/nginx/conf.d/default.conf
 
簡単なリバースプロキシ 
/etc/nginx/conf.d 以下に XXX.confという命名でファイルを作成する。 
ココでは server.conf とし、80 番で受けたリクエストを 8000 番に転送する。 
sudo nano /etc/nginx/conf.d/server.conf
 
server {
listen 80;
# アクセス可能なIPアドレスもしくはドメイン
server_name hogehoge.com;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $http_host;
proxy_redirect off;
proxy_max_temp_file_size 0;
location / {
proxy_pass http://localhost:8000;
}
}
 

== Nginxの基本コマンド ==
起動 
sudo systemctl start nginx
 
停止 
sudo systemctl stop nginx
 
再起動 
sudo systemctl restart nginx
 
再起動しても設定ファイルが反映されない場合 
sudo nginx -s reload
 
状態の確認 
sudo systemctl status nginx
 

__FORCETOC__
[[カテゴリ:CentOS]]

インストール - Git

2019-12-07T10:05:03Z

192.168.1.17: /* ビルドしてインストール */

== 概要 ==
aptやyum等のLinuxのパッケージマネージャーでインストールしたGitはバージョンが古いことが多い。 
 
パッケージ一覧を返すコマンド(yum list installedまたはrpm -qa)を使用して、 
文字列検索するgrepコマンドにパイプで渡すことで探したいパッケージ名の一覧を得ることができる。 
 
Gitのバージョンが古くても最低限のことは問題ないが、Git2.8以降では、user.useConfigOnly という設定が追加され、 
これを有効にすることで、ユーザ名やメールアドレスを設定していない時に環境変数を使用して勝手にユーザ情報を参照してしまうことを防ぐことができる。 
 

== 既存のGitをアンインストール ==
既にパッケージマネージャーでGitをインストールしている場合は、 
以下のコマンドを入力してアンインストールする。 
sudo yum remove git
 

== rpmパッケージの検査に必要なライブラリをインストール ==
まず、必要なライブラリをインストールする。 
以下のコマンドを入力する。 
sudo yum install curl-devel expat-devel gettext-devel openssl-devel perl-devel zlib-devel autoconf asciidoc xmlto docbook2X make gcc
sudo ln -s /usr/bin/db2x_docbook2texi /usr/bin/docbook2x-texi
 

== ソースコードをダウンロード ==
以下のGitHubのWebサイトにアクセスして、最新のGitのソースコードをダウンロードする。 
https://github.com/git/git/releases
 

== ビルドしてインストール ==
ダウンロードしたGitのソースコードを展開して、展開されたディレクトリに移動する。 
その後、以下のコマンドを入力してビルドおよびインストールする。 
make configure
 
./configure --prefix=/usr/local
 
make all doc info
 
sudo make install install-doc install-html install-info
 

== 確認 ==
以下のコマンドを入力して、インストールしたGitのバージョンを確認する。 
git –version
 

__FORCETOC__
[[カテゴリ:CentOS]]

インストール - Git

2019-12-07T10:01:08Z

192.168.1.17: ページの作成:「== 概要 == aptやyum等のLinuxのパッケージマネージャーでインストールしたGitはバージョンが古いことが多い。 パッケージ…」

== 概要 ==
aptやyum等のLinuxのパッケージマネージャーでインストールしたGitはバージョンが古いことが多い。 
 
パッケージ一覧を返すコマンド(yum list installedまたはrpm -qa)を使用して、 
文字列検索するgrepコマンドにパイプで渡すことで探したいパッケージ名の一覧を得ることができる。 
 
Gitのバージョンが古くても最低限のことは問題ないが、Git2.8以降では、user.useConfigOnly という設定が追加され、 
これを有効にすることで、ユーザ名やメールアドレスを設定していない時に環境変数を使用して勝手にユーザ情報を参照してしまうことを防ぐことができる。 
 

== 既存のGitをアンインストール ==
既にパッケージマネージャーでGitをインストールしている場合は、 
以下のコマンドを入力してアンインストールする。 
sudo yum remove git
 

== rpmパッケージの検査に必要なライブラリをインストール ==
まず、必要なライブラリをインストールする。 
以下のコマンドを入力する。 
sudo yum install curl-devel expat-devel gettext-devel openssl-devel perl-devel zlib-devel autoconf asciidoc xmlto docbook2X make gcc
sudo ln -s /usr/bin/db2x_docbook2texi /usr/bin/docbook2x-texi
 

== ソースコードをダウンロード ==
以下のGitHubのWebサイトにアクセスして、最新のGitのソースコードをダウンロードする。 
https://github.com/git/git/releases
 

== ビルドしてインストール ==
ダウンロードしたGitのソースコードを展開して、展開されたディレクトリに移動する。 
その後、以下のコマンドを入力してビルドおよびインストールする。 
make configure
 
./configure --prefix=/usr
 
make all doc info
 
sudo make install install-doc install-html install-info
 

== 確認 ==
以下のコマンドを入力して、インストールしたGitのバージョンを確認する。 
git –version
 

__FORCETOC__
[[カテゴリ:CentOS]]

設定 - レガシーカーネル

2019-12-07T08:55:45Z

192.168.1.17:

== 概要 ==
一般的に、カーネルをアップデートしても古いカーネルは削除せず、 
新バージョンとともに旧バージョンのカーネルもGRUBから起動できるようにすることが多い。 
新バージョンがうまく動かない場合を考えると安心できるシステムだが、カーネルのアップデートが比較的短い間隔で行われるディストリビューションでは、 
ディスクスペースが圧迫されてしまうしGRUBのメニューも煩雑になる。 
 

== 古いカーネルを削除する ==
CentOSでは、yum-utilsというパッケージが用意されており、その中のpackage-cleanupコマンドを実行すれば、古いカーネルを簡単に削除できる。 
まず、以下のコマンドを入力し、yum-utilsをインストールする。 
sudo yum install yum-utils
 
yum-utilsのインストールが完了したら、--oldkernelsオプションを付けてpackage-cleanupコマンドを実行する。 
sudo package-cleanup --oldkernels
 
初期設定では、最新カーネルと1世代前のカーネルを残し、それよりも古いカーネル(kernelとkernel-devel)が削除される。 
もっと古いカーネルも残したい場合は、”package-cleanup”コマンド実行時に、”--count=残すカーネル数”を追加する。 
例えば、最新版および2世代前のカーネルまで残すなら、以下のようにする。 
sudo package-cleanup --oldkernels --count=3
 

__FORCETOC__
[[カテゴリ:CentOS]]

設定 - レガシーカーネル

2019-12-07T08:55:29Z

192.168.1.17: ページの作成:「== 概要 == 一般的に、カーネルをアップデートしても古いカーネルは削除せず、 新バージョンとともに旧バージョンのカー…」

== 概要 ==
一般的に、カーネルをアップデートしても古いカーネルは削除せず、 
新バージョンとともに旧バージョンのカーネルもGRUBから起動できるようにすることが多い。 
新バージョンがうまく動かない場合を考えると安心できるシステムだが、カーネルのアップデートが比較的短い間隔で行われるディストリビューションでは、 
ディスクスペースが圧迫されてしまうしGRUBのメニューも煩雑になる。 
 

== 古いカーネルを削除する ==
CentOSでは、yum-utilsというパッケージが用意されており、その中のpackage-cleanupコマンドを実行すれば、古いカーネルを簡単に削除できる。 
まず、以下のコマンドを入力し、yum-utilsをインストールする。 
sudo yum install yum-utils
 
yum-utilsのインストールが完了したら、--oldkernelsオプションを付けてpackage-cleanupコマンドを実行する。 
sudo package-cleanup --oldkernels
 
初期設定では、最新カーネルと1世代前のカーネルを残し、それよりも古いカーネル(kernelとkernel-devel)が削除される。 
もっと古いカーネルも残したい場合は、”package-cleanup”コマンド実行時に、”--count=残すカーネル数”を追加する。 
例えば、最新版および2世代前のカーネルまで残すなら、以下のようにする。 
“sudo package-cleanup --oldkernels --count=3”
 

__FORCETOC__
[[カテゴリ:CentOS]]

インストール - Xdebug

2019-12-06T12:39:59Z

192.168.1.17: /* 設定方法 */

== 概要 ==
以下のコマンドを実行する。 
sudo yum install php73-pecl-xdebug.x86_64
 

== インストール方法 ==
まず、Xdebugの[https://xdebug.org/download サイト]に行き、Xdebugのソースファイルをダウンロードする。 
以下のコマンドを入力して解凍する。 
tar zxvf xdebug-x.x.x.tgz
 
解凍したXdebugのディレクトリに移動し、phpizeコマンドを実行する。 
cd xdebug-2.8.1
phpize
 
===== configureを実行する =====
configureというシェルスクリプトを実行することで、ソースファイルをコンパイルする前に、 
インストール対象となるシステム特有の機能や情報をチェックし、チェック状況を記述したMakefileを作成する。 
もし、configureに失敗する場合は、コンパイルに必要なライブラリやヘッダファイル等が不足している事がほとんどなので、 
エラーメッセージの内容を確認し、必要なパッケージを事前にインストールしておく。 
./configure --enable-xdebug
 
===== makeコマンドを実行する =====
configureの実行により作成されたMakefileを元に、makeコマンドを実行することで、ソースファイルのコンパイルを行う。 
コンパイル時にエラーが表示されるようであれば、エラー内容を確認し、configure実行時に必要なパラメータが不足していないか確認する。 
make
 
===== make installコマンドを実行する(インストール) =====
makeコマンド実行時にエラーが表示されなければコンパイル完了なので、(コンパイル途中に警告メッセージが表示される場合がある、これは無視してもよい) 
sudo make install
 
作成されたxdebug.soファイルを/usr/local/binディレクトリにコピーする。 
sudo cp -a modules/xdebug.so /usr/lib64/php/modules
 

== 設定方法 ==
PHPのXdebug設定ファイルを開く。 
sudo gedit /etc/php.d/15-xdebug.ini
 
Xdebug設定ファイルを編集する。 
※OPCacheを使用する場合は、OPCacheの設定行の後にzend_extensionを入力すること。 
1行目を編集
zend_extension = /usr/lib64/php/modules/xdebug.so

最後尾の行に以下を追加
[xdebug]
xdebug.dump_undefined = 1
xdebug.remote_log="/tmp/xdebug.log"
xdebug.remote_enable = 1
xdebug.remote_host=localhost
xdebug.remote_port=9000
xdebug.remote_handler=dbgp
xdebug.remote_mode=req
xdebug.remote_autostart = 1
xdebug.idekey=VSCODE
 

== 確認方法 ==
以下のコマンドを入力して、xdebugと表示されているならば成功である。 
php -m | grep xdebug
 

__FORCETOC__
[[カテゴリ:CentOS]]

インストール - Xdebug

2019-12-06T12:39:14Z

192.168.1.17: /* make installコマンドを実行する(インストール) */

== 概要 ==
以下のコマンドを実行する。 
sudo yum install php73-pecl-xdebug.x86_64
 

== インストール方法 ==
まず、Xdebugの[https://xdebug.org/download サイト]に行き、Xdebugのソースファイルをダウンロードする。 
以下のコマンドを入力して解凍する。 
tar zxvf xdebug-x.x.x.tgz
 
解凍したXdebugのディレクトリに移動し、phpizeコマンドを実行する。 
cd xdebug-2.8.1
phpize
 
===== configureを実行する =====
configureというシェルスクリプトを実行することで、ソースファイルをコンパイルする前に、 
インストール対象となるシステム特有の機能や情報をチェックし、チェック状況を記述したMakefileを作成する。 
もし、configureに失敗する場合は、コンパイルに必要なライブラリやヘッダファイル等が不足している事がほとんどなので、 
エラーメッセージの内容を確認し、必要なパッケージを事前にインストールしておく。 
./configure --enable-xdebug
 
===== makeコマンドを実行する =====
configureの実行により作成されたMakefileを元に、makeコマンドを実行することで、ソースファイルのコンパイルを行う。 
コンパイル時にエラーが表示されるようであれば、エラー内容を確認し、configure実行時に必要なパラメータが不足していないか確認する。 
make
 
===== make installコマンドを実行する(インストール) =====
makeコマンド実行時にエラーが表示されなければコンパイル完了なので、(コンパイル途中に警告メッセージが表示される場合がある、これは無視してもよい) 
sudo make install
 
作成されたxdebug.soファイルを/usr/local/binディレクトリにコピーする。 
sudo cp -a modules/xdebug.so /usr/lib64/php/modules
 

== 設定方法 ==
PHPのXdebug設定ファイルを開く。 
sudo gedit /etc/php.d/15-xdebug.ini
 
Xdebug設定ファイルを編集する。 
※OPCacheを使用する場合は、OPCacheの設定行の後にzend_extensionを入力すること。 
1行目を編集
zend_extension = /usr/local/bin/xdebug.so

最後尾の行に以下を追加
[xdebug]
xdebug.dump_undefined = 1
xdebug.remote_log="/tmp/xdebug.log"
xdebug.remote_enable = 1
xdebug.remote_host=localhost
xdebug.remote_port=9000
xdebug.remote_handler=dbgp
xdebug.remote_mode=req
xdebug.remote_autostart = 1
xdebug.idekey=VSCODE
 

== 確認方法 ==
以下のコマンドを入力して、xdebugと表示されているならば成功である。 
php -m | grep xdebug
 

__FORCETOC__
[[カテゴリ:CentOS]]

インストール - Xdebug

2019-12-06T12:15:03Z

192.168.1.17: /* 設定方法 */

== 概要 ==
以下のコマンドを実行する。 
sudo yum install php73-pecl-xdebug.x86_64
 

== インストール方法 ==
まず、Xdebugの[https://xdebug.org/download サイト]に行き、Xdebugのソースファイルをダウンロードする。 
以下のコマンドを入力して解凍する。 
tar zxvf xdebug-x.x.x.tgz
 
解凍したXdebugのディレクトリに移動し、phpizeコマンドを実行する。 
cd xdebug-2.8.1
phpize
 
===== configureを実行する =====
configureというシェルスクリプトを実行することで、ソースファイルをコンパイルする前に、 
インストール対象となるシステム特有の機能や情報をチェックし、チェック状況を記述したMakefileを作成する。 
もし、configureに失敗する場合は、コンパイルに必要なライブラリやヘッダファイル等が不足している事がほとんどなので、 
エラーメッセージの内容を確認し、必要なパッケージを事前にインストールしておく。 
./configure --enable-xdebug
 
===== makeコマンドを実行する =====
configureの実行により作成されたMakefileを元に、makeコマンドを実行することで、ソースファイルのコンパイルを行う。 
コンパイル時にエラーが表示されるようであれば、エラー内容を確認し、configure実行時に必要なパラメータが不足していないか確認する。 
make
 
===== make installコマンドを実行する(インストール) =====
makeコマンド実行時にエラーが表示されなければコンパイル完了なので、(コンパイル途中に警告メッセージが表示される場合がある、これは無視してもよい) 
make install
 
作成されたxdebug.soファイルを/usr/local/binディレクトリにコピーする。 
sudo cp -a modules/xdebug.so /usr/local/bin
 

== 設定方法 ==
PHPのXdebug設定ファイルを開く。 
sudo gedit /etc/php.d/15-xdebug.ini
 
Xdebug設定ファイルを編集する。 
※OPCacheを使用する場合は、OPCacheの設定行の後にzend_extensionを入力すること。 
1行目を編集
zend_extension = /usr/local/bin/xdebug.so

最後尾の行に以下を追加
[xdebug]
xdebug.dump_undefined = 1
xdebug.remote_log="/tmp/xdebug.log"
xdebug.remote_enable = 1
xdebug.remote_host=localhost
xdebug.remote_port=9000
xdebug.remote_handler=dbgp
xdebug.remote_mode=req
xdebug.remote_autostart = 1
xdebug.idekey=VSCODE
 

== 確認方法 ==
以下のコマンドを入力して、xdebugと表示されているならば成功である。 
php -m | grep xdebug
 

__FORCETOC__
[[カテゴリ:CentOS]]

インストール - Xdebug

2019-12-06T11:27:22Z

192.168.1.17: /* 設定方法 */

== 概要 ==
以下のコマンドを実行する。 
sudo yum install php73-pecl-xdebug.x86_64
 

== インストール方法 ==
まず、Xdebugの[https://xdebug.org/download サイト]に行き、Xdebugのソースファイルをダウンロードする。 
以下のコマンドを入力して解凍する。 
tar zxvf xdebug-x.x.x.tgz
 
解凍したXdebugのディレクトリに移動し、phpizeコマンドを実行する。 
cd xdebug-2.8.1
phpize
 
===== configureを実行する =====
configureというシェルスクリプトを実行することで、ソースファイルをコンパイルする前に、 
インストール対象となるシステム特有の機能や情報をチェックし、チェック状況を記述したMakefileを作成する。 
もし、configureに失敗する場合は、コンパイルに必要なライブラリやヘッダファイル等が不足している事がほとんどなので、 
エラーメッセージの内容を確認し、必要なパッケージを事前にインストールしておく。 
./configure --enable-xdebug
 
===== makeコマンドを実行する =====
configureの実行により作成されたMakefileを元に、makeコマンドを実行することで、ソースファイルのコンパイルを行う。 
コンパイル時にエラーが表示されるようであれば、エラー内容を確認し、configure実行時に必要なパラメータが不足していないか確認する。 
make
 
===== make installコマンドを実行する(インストール) =====
makeコマンド実行時にエラーが表示されなければコンパイル完了なので、(コンパイル途中に警告メッセージが表示される場合がある、これは無視してもよい) 
make install
 
作成されたxdebug.soファイルを/usr/local/binディレクトリにコピーする。 
sudo cp -a modules/xdebug.so /usr/local/bin
 

== 設定方法 ==
PHPのXdebug設定ファイルを開く。 
sudo gedit /etc/php.d/15-xdebug.ini
 
Xdebug設定ファイルを編集する。 
※OPCacheを使用する場合は、OPCacheの設定行の後にzend_extensionを入力すること。 
1行目を編集
zend_extension = /usr/local/bin/xdebug.so

最後尾の行に以下を追加
xdebug.dump_undefined = 1
xdebug.remote_log="/tmp/xdebug.log"
xdebug.profiler_enable = 1
xdebug.remote_enable=on
xdebug.remote_host=localhost
xdebug.remote_port=9000
xdebug.remote_handler=dbgp
xdebug.remote_autostart = 1
xdebug.remote_mode=req
xdebug.remote_connect_back=on
xdebug.idekey=editor-xdebug
 

== 確認方法 ==
以下のコマンドを入力して、xdebugと表示されているならば成功である。 
php -m | grep xdebug
 

__FORCETOC__
[[カテゴリ:CentOS]]

インストール - Xdebug

2019-12-06T11:09:49Z

192.168.1.17:

== 概要 ==
以下のコマンドを実行する。 
sudo yum install php73-pecl-xdebug.x86_64
 

== インストール方法 ==
まず、Xdebugの[https://xdebug.org/download サイト]に行き、Xdebugのソースファイルをダウンロードする。 
以下のコマンドを入力して解凍する。 
tar zxvf xdebug-x.x.x.tgz
 
解凍したXdebugのディレクトリに移動し、phpizeコマンドを実行する。 
cd xdebug-2.8.1
phpize
 
===== configureを実行する =====
configureというシェルスクリプトを実行することで、ソースファイルをコンパイルする前に、 
インストール対象となるシステム特有の機能や情報をチェックし、チェック状況を記述したMakefileを作成する。 
もし、configureに失敗する場合は、コンパイルに必要なライブラリやヘッダファイル等が不足している事がほとんどなので、 
エラーメッセージの内容を確認し、必要なパッケージを事前にインストールしておく。 
./configure --enable-xdebug
 
===== makeコマンドを実行する =====
configureの実行により作成されたMakefileを元に、makeコマンドを実行することで、ソースファイルのコンパイルを行う。 
コンパイル時にエラーが表示されるようであれば、エラー内容を確認し、configure実行時に必要なパラメータが不足していないか確認する。 
make
 
===== make installコマンドを実行する(インストール) =====
makeコマンド実行時にエラーが表示されなければコンパイル完了なので、(コンパイル途中に警告メッセージが表示される場合がある、これは無視してもよい) 
make install
 
作成されたxdebug.soファイルを/usr/local/binディレクトリにコピーする。 
sudo cp -a modules/xdebug.so /usr/local/bin
 

== 設定方法 ==
PHPのXdebug設定ファイルを開く。 
sudo gedit /etc/php.d/15-xdebug.ini
 
Xdebug設定ファイルを編集する。 
※OPCacheを使用する場合は、OPCacheの設定行の後にzend_extensionを入力すること。 
1行目を編集
zend_extension = /usr/local/bin/xdebug.so

最後尾の行に以下を追加
xdebug.remote_log="/tmp/xdebug.log"
xdebug.profiler_enable = 1
xdebug.remote_enable=on
xdebug.remote_port=9000
xdebug.remote_autostart=0
xdebug.remote_connect_back=on
xdebug.idekey=editor-xdebug
 

== 確認方法 ==
以下のコマンドを入力して、xdebugと表示されているならば成功である。 
php -m | grep xdebug
 

__FORCETOC__
[[カテゴリ:CentOS]]

インストール - PHP

2019-12-06T08:27:30Z

192.168.1.17: ページの作成:「== 概要 == CentOS7の標準リポジトリのPHPは5.4だが、PHPの現時点での最新バージョンは7.3.6である。(2019/6/17) また、PHP7以降は大…」

== 概要 ==
CentOS7の標準リポジトリのPHPは5.4だが、PHPの現時点での最新バージョンは7.3.6である。(2019/6/17) 
また、PHP7以降は大幅な改良がされており、実行速度をはじめ様々なものがアップデートされているので、特別な事情がない限りはアップグレードした方がよい。 
 

== PHP7のインストール ==
PHP5をアンインストールするため、以下のコマンドを実行する。 
このとき、php.iniファイルを変更している場合はバックアップを取る。 
これは、新しいPHPをインストールした時点でphp.iniファイルが上書きされるためである。 
sudo yum remove php-*
 
次に、PHP7をインストールする。 
インストールは、--enablerepoオプションを付加して、以下のコマンドを実行する。 
アップデート後は、php.iniファイルが上書きされているのでバックアップから復元する。 
sudo yum --enablerepo=remi-php73 install php php-cli.x86_64 php-pdo.x86_64 php-gd.x86_64 php-mbstring.x86_64 php-common.x86_64 php-mysql php73-devel
 

== 確認方法 ==
最後に、インストールされたPHPのバージョンを確認するため、以下のコマンドを実行する。 
php -v
 
運用していく上で必要な関連パッケージがあれば、適宜追加する。 
 

== インストール時の注意点 ==
PHP7をインストールするとき、旧バージョンのPHPが指定されることを防ぐため、一旦すべてのリポジトリを無効化し、PHP7のリポジトリを指定する。 
sudo yum --disablerepo=* --enablerepo=remi,remi-php73 install php hp-cli.x86_64 php-pdo.x86_64 php-gd.x86_64 php-mbstring.x86_64 php-common.x86_64 php-mysql php73-devel
 
EPELリポジトリおよびRemiリポジトリの追加方法で、EPELリポジトリの公開鍵を取得するためにlibargon2をインストールしているが、 
このパッケージは、PHP7をインストールする際に依存性パッケージとして必要になる。 
もし、libargon2をインストールせずにPHPをインストールしようとすると、恐らくEPELが無いために依存性が解決されない。 
PHP7をインストールする前に、以下のコマンドを実行してlibargon2をインストールする。 
sudo yum --disablerepo=* --enablerepo=epel install libargon2
 

__FORCETOC__
[[カテゴリ:CentOS]]

インストール - Xdebug

2019-12-06T08:20:57Z

192.168.1.17: /* インストール方法 */

== 概要 ==

== インストール方法 ==
まず、Xdebugの[https://xdebug.org/download サイト]に行き、Xdebugのソースファイルをダウンロードする。 
以下のコマンドを入力して解凍する。 
tar zxvf xdebug-x.x.x.tgz
 
解凍したXdebugのディレクトリに移動し、phpizeコマンドを実行する。 
cd xdebug-2.8.1
phpize
 
===== configureを実行する =====
configureというシェルスクリプトを実行することで、ソースファイルをコンパイルする前に、 
インストール対象となるシステム特有の機能や情報をチェックし、チェック状況を記述したMakefileを作成する。 
もし、configureに失敗する場合は、コンパイルに必要なライブラリやヘッダファイル等が不足している事がほとんどなので、 
エラーメッセージの内容を確認し、必要なパッケージを事前にインストールしておく。 
./configure --enable-xdebug
 
===== makeコマンドを実行する =====
configureの実行により作成されたMakefileを元に、makeコマンドを実行することで、ソースファイルのコンパイルを行う。 
コンパイル時にエラーが表示されるようであれば、エラー内容を確認し、configure実行時に必要なパラメータが不足していないか確認する。 
make
 
===== make installコマンドを実行する(インストール) =====
makeコマンド実行時にエラーが表示されなければコンパイル完了なので、(コンパイル途中に警告メッセージが表示される場合がある、これは無視してもよい) 
make install
 
作成されたxdebug.soファイルを/usr/local/binディレクトリにコピーする。 
sudo cp -a modules/xdebug.so /usr/local/bin
 

== 設定方法 ==
PHPのXdebug設定ファイルを開く。 
sudo gedit /etc/php.d/15-xdebug.ini
 
Xdebug設定ファイルを編集する。 
※OPCacheを使用する場合は、OPCacheの設定行の後にzend_extensionを入力すること。 
1行目を編集
zend_extension = /usr/local/bin/xdebug.so

最後尾の行に以下を追加
xdebug.remote_log="/tmp/xdebug.log"
xdebug.profiler_enable = 1
xdebug.remote_enable=on
xdebug.remote_port=9000
xdebug.remote_autostart=0
xdebug.remote_connect_back=on
xdebug.idekey=editor-xdebug
 

== 確認方法 ==
以下のコマンドを入力して、xdebugと表示されているならば成功である。 
php -m | grep xdebug
 

__FORCETOC__
[[カテゴリ:CentOS]]

インストール - Xdebug

2019-12-06T08:18:38Z

192.168.1.17: ページの作成:「== 概要 == == インストール方法 == まず、Xdebugの[https://xdebug.org/download サイト]に行き、Xdebugのソースファイルをダウンロードす…」

== 概要 ==

== インストール方法 ==
まず、Xdebugの[https://xdebug.org/download サイト]に行き、Xdebugのソースファイルをダウンロードする。 
以下のコマンドを入力して解凍する。 
tar zxvf xdebug-x.x.x.tgz
 
解凍したXdebugのディレクトリに移動し、phpizeコマンドを実行する。 
cd xdebug-2.8.1
phpize
 

===== configureを実行する =====
configureというシェルスクリプトを実行することで、ソースファイルをコンパイルする前に、 
インストール対象となるシステム特有の機能や情報をチェックし、チェック状況を記述したMakefileを作成する。 
もし、configureに失敗する場合は、コンパイルに必要なライブラリやヘッダファイル等が不足している事がほとんどなので、 
エラーメッセージの内容を確認し、必要なパッケージを事前にインストールしておく。 
./configure --enable-xdebug
 
===== makeコマンドを実行する =====
configureの実行により作成されたMakefileを元に、makeコマンドを実行することで、ソースファイルのコンパイルを行う。 
コンパイル時にエラーが表示されるようであれば、エラー内容を確認し、configure実行時に必要なパラメータが不足していないか確認する。 
make
 
===== make installコマンドを実行する(インストール) =====
makeコマンド実行時にエラーが表示されなければコンパイル完了なので、(コンパイル途中に警告メッセージが表示される場合がある、これは無視してもよい) 
make install
 
作成されたxdebug.soファイルを/usr/local/binディレクトリにコピーする。 
sudo cp -a modules/xdebug.so /usr/local/bin
 

== 設定方法 ==
PHPのXdebug設定ファイルを開く。 
sudo gedit /etc/php.d/15-xdebug.ini
 
Xdebug設定ファイルを編集する。 
※OPCacheを使用する場合は、OPCacheの設定行の後にzend_extensionを入力すること。 
1行目を編集
zend_extension = /usr/local/bin/xdebug.so

最後尾の行に以下を追加
xdebug.remote_log="/tmp/xdebug.log"
xdebug.profiler_enable = 1
xdebug.remote_enable=on
xdebug.remote_port=9000
xdebug.remote_autostart=0
xdebug.remote_connect_back=on
xdebug.idekey=editor-xdebug
 

== 確認方法 ==
以下のコマンドを入力して、xdebugと表示されているならば成功である。 
php -m | grep xdebug
 

__FORCETOC__
[[カテゴリ:CentOS]]

ライブラリの基礎 - C++DLL

2019-12-05T05:37:49Z

192.168.1.17: /* サンプルコード */

== 概要 ==
C# EXEからC++ DLLへ様々なデータ型の変数を渡したいときがある。 
 
例えば、C++ DLLから次のような関数がエクスポートされているとする。 
<source lang="c++">
void WINAPI ConvertToShort(char *pstr, short *pret);
</source>
 
上記の関数において、C# EXEから使用するときは、char*型は文字列なのでstring型を渡す。 
short*型はIntPtr型を渡す。(IntPtr型は汎用ポインタを表す型であり、void*型とほぼ同義) 
 
但し、C#は厳しい型付け言語なので、曖昧さを解決するために変換メソッドを経由する必要がある。 
具体的には、IntPtr型の変数にMarshal.AllocHGlobal関数で必要なサイズのメモリを確保して、それをC++ DLLに渡した後、 
Marshal.ReadInt16関数(型によって異なる)等で変換した後、確保したメモリをMarshal.FreeHGlobal関数で解放するというプロセスを経る必要がある。 
 

== サンプルコード ==
下記に、C++ DLLを呼ぶC# EXEのソースコードを記載する。 
<source lang="c#">
// DllImportを使用するために必要
using System.Runtime.InteropServices;

[DllImport("DrsUtil.dll", EntryPoint = "ConvertToShort")]
extern static void _ConvertToShort(string pstr, IntPtr pret); //呼び出し元の名前変えちゃう

public static short ConvertToShort(string str)
{
IntPtr buffer = new IntPtr();
buffer = Marshal.AllocHGlobal(2); // 2バイトのメモリ確保
_ConvertToShort(str, buffer); // C++/DLLの関数を呼ぶ
short sval = Marshal.ReadInt16(buffer); // 変換
Marshal.FreeHGlobal(buffer); // メモリ開放
return sval;
}
</source>
 
IntPtr型の変数は様々なものが入るので、例えば、構造体を取得することも可能だが、C# EXEで構造体を定義しなければいけない。 
WindowsのDLL(Win32 API)と.NET Frameworkでは型の管理方法が違うため、実際には型の相互変換(マーシャリング)が行われる。 
尚、BOOL型の実体はLONG型と同じなので、boolの代わりにintを指定することも可能である。 
 
<center>'''表1. Win32 APIでの型名と対応するC#の型'''</center>
<center>
{| class="wikitable"
|-
! APIの型名 (括弧内は対応するC言語の型) !! 対応するC#の型 (括弧内は.NET Frameworkでの型名) !! 備考
|-
| HANDLE (void *) || System.IntPtr System.UIntPtr || x86は4バイト x64は8バイト
|-
| BYTE (unsigned char) || byte (System.Byte) ||
|-
| SHORT (short) || short (System.Int16) ||
|-
| WORD (unsigned short) || ushort (System.UInt16) ||
|-
| INT (int) LONG (long) || int (System.Int32) ||
|-
| UINT (unsigned int) DWORD, ULONG (unsigned long) || uint (System.UInt32) ||
|-
| BOOL (long) || bool (System.Boolean) ||
|-
| CHAR (char) || 文字を渡すとき char (System.Char) 文字を受け取るとき StringBuilder ||
|-
| WCHAR(wchar_t) || 文字を渡すとき char (System.Char) 文字を受け取るとき StringBuilder ||
|-
| LPSTR (char *, char[]) LPWSTR (wchar_t *, wchar_t[]) || 文字を渡すとき string (System.String) 文字を受け取るとき System.Text.StringBuilder ||
|-
| LPCSTR (const char *, const char[]) LPCWSTR (const wchar_t *, const wchar_t[]) || 文字を渡すとき string (System.String) 文字を受け取るとき System.Text.StringBuilder ||
|-
| FLOAT (float) || float (System.Single) ||
|-
| DOUBLE (double) || double (System.Double) ||
|}
</center>
 

== サンプルコード ==
C++ DLLの作成方法は[[DLLを作成する(MFC)|コチラを参照]]する。 
下記にもC++ DLLを記述する。 
<source lang="c++">
SampleDLL.h

double __stdcall SampleFunc01(int a);
void __stdcall SampleFunc02(int a, char *pstr)
void __stdcall SampleFunc03(int a, char *pstr)
void __stdcall SampleFunc04(SampleStruct st)
void __stdcall SampleFunc05(SampleStruct *pStructure)
</source>
<source lang="c++">
SampleDll.cpp

#include <stdio.h>
#include <string.h>
#include "SampleDll.h"

typedef struct tagSampleStruct
{
int index;
char name[128];
int data[50];
} SampleStruct, *pSampleStruct;

typedef struct tagSampleStruct2
{
int length;
double *data;
} SampleStruct2, *pSampleStruct2;

double __stdcall SampleFunc01(int a)
{
printf(--<SampleDll:SampleFunc01>--\r\n");
printf("a = %d\r\n", a);
printf("---------------------------\r\n");

return 3.14;
}

void __stdcall SampleFunc02(int a, char *pstr)
{
printf("--<SampleDll:SampleFunc02>--\r\n");
printf("[%d] %s\r\n", a, str);
printf("-----------------------------\r\n");
}

void __stdcall SampleFunc03(int a, char *pstr)
{
printf("--<SampleDll:SampleFunc03>--\r\n");
printf("[%d] %s\r\n", a, str);
sprintf_s(str, 256, "C++ DLL側から文字列を返す場合は、StringBuilderクラスを使用する");
printf("------------------------\r\n");
}

void __stdcall SampleFunc04(SampleStruct st)
{
printf("--<SampleDll:Sample04>--\r\n");
printf("index = %d\r\n", st.index);
printf("name = %s\r\n", st.name);
printf("data[0] = %d, data[1] = %d, data[2] = %d, data[3] = %d\r\n", st.data[0], st.data[1], st.data[2], st.data[3]);
printf("------------------------\r\n");
}

void __stdcall SampleFunc05(SampleStruct2 *pStructure)
{
dData[256] = {0};
printf("--<SampleDll:Sample05>--\r\n");
memset(pStructure, 0, sizeof(SampleStruct2));
pStructure->length = 10;
pStructure->data = dData;
for(int i = 0; i < pStructure->length; i++)
{
dData[i] = (i + 1) / 10.0;
}
printf("------------------------\r\n");
}
</source>
<source lang="c++">
SampleDll.def // モジュール定義ファイル

LIBRARY SampleDll

EXPORTS
; 公開する関数名をリストアップ
SampleFunc01 @1
SampleFunc02 @2
SampleFunc03 @3
SampleFunc04 @4
SampleFunc05 @5
</source>
 
次に、C# EXE側でC++ DLLを呼び出す方法を記述する。 
文字列をC++ DLL側に渡す場合は、string型を使用する。 
文字列をC++ DLL側から返す場合は、string型ではなくStringBuilderクラスを使用する必要がある。 
StringBuilderクラスは受け渡しの両方が可能なので、文字列はStringBuilderクラスを使用すべきである。 
 
C++では構造体のサイズはコンパイル時に決定されるが、C#では実行時に決定される。 
したがって、C#側で構造体のサイズを予め指定する必要がある。 
この場合、構造体は固定長サイズとなるため、配列などを定義する場合は異なるサイズの配列を後からインスタンス化することができなくなる。 
 
構造体をC++ DLL側から返す場合、IntPtr型からdouble型の配列を取得するときは、一度Int64型に変換し、これをBitConverter.Int64BitsToDouble()メソッドでdouble型に変換する。 
<source lang="c#">
using System;
using System.Text;
using System.Runtime.InteropServices;

namespace SampleEXE
{
class Program
{
/// <summary>
/// 最も基本的な関数のインポート例
/// </summary>
/// <param name="a">4 バイト符号付き整数を指定します。</param>
/// <returns>倍精度浮動小数を返します。</returns>
[DllImport("SampleDLL.dll")]
private static extern double SampleFunc01(int a);

[DllImport("SampleDLL.dll", CharSet = CharSet.Unicode)]
// C++ DLL側の文字コードがUnicodeの場合は"CharSet = CharSet.Unicode"と明示的に指定する
private static extern void SampleFunc02(int a, string str);

[DllImport("SampleDLL.dll", CharSet = CharSet.Unicode)]
// C++ DLL側の文字コードがUnicodeの場合は"CharSet = CharSet.Unicode"と明示的に指定する
private static extern void SampleFunc03(int a, StringBuilder str);

/// <summary>
/// 構造体を引数に持つ関数のインポート例
/// </summary>
/// <param name="st">DLL 側に渡す構造体を指定します</param>
[DllImport("SampleDLL.dll")]
private static extern void SampleFunc04(SampleStruct st);

/// <summary>
/// DLL側からメンバにポインタを含む構造体を受け取る関数のインポート例
/// </summary>
/// <param name="pst">受け渡す構造体の先頭アドレスを示すポインタを指定する</param>
[DllImport("SampleDLL.dll")]
private static extern void SampleFunc05(IntPtr pst);

/// <summary>
/// DLLとの取り合いのために定義する構造体
/// LayoutKind.Sequentialを指定することで、C/C++同様、変数の宣言順通りにメモリに配置されるようになる
/// </summary>
[StructLayout(LayoutKind.Sequential)]
private struct SampleStruct
{
/// <summary>
/// 4バイト符号付整数
/// </summary>
[MarshalAs(UnmanagedType.I4)]
public int index;

/// <summary>
/// 固定長文字配列(SizeConstは配列のサイズを示す)
/// </summary>
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 128)]
public string name;

/// <summary>
/// 固定長配列(SizeConstは配列の要素数を示す)
/// </summary>
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 50)]
public int[] data;
}

/// <summary>
/// DLLとの取り合いのために定義する構造体
/// LayoutKind.Sequentialを指定することで、C/C++同様、変数の宣言順通りにメモリに配置されるようにする
/// </summary>
[StructLayout(LayoutKind.Sequential)]
private struct SampleStruct2
{
public int length;
public IntPtr data;
}
　
static void Main(string[] args)
{
var dRet= SampleFunc01(1);
Console.WriteLine(dRet);
Console.WriteLine();

var str = "string型で文字列を渡すことができます。";
SampleFunc02(2, str);

var strb = new System.Text.StringBuilder(256);
strb.Append("文字列のバッファを渡す場合は StringBuilder クラスで受け渡します。");
SampleFunc03(3, strb);
Console.WriteLine(strb);

var structHoge = new SampleStruct()
{
index = 4,
name = "構造体サンプル",
data = new int[50],
};

structHoge.data[0] = 11;
structHoge.data[1] = 22;
structHoge.data[2] = 33;
SampleFunc04(structHoge);

// SampleStruct2構造体のサイズを取得する
// 指定サイズ分だけメモリ領域を確保して、その先頭アドレスをstructPiyoに格納する
var structPiyo = Marshal.AllocHGlobal(Marshal.SizeOf(typeof(SampleStruct2)));
try
{
SampleFunc05(structPiyo);
// 受け取ったstructPiyoからSampleStruct2構造体の情報に構築し直す
var structFuga = (SampleStruct2)Marshal.PtrToStructure(structPiyo, typeof(SampleStruct2));
for (int i = 0; i < structFuga.length; i++)
{
// IntPtr型からdouble型の数値を取得するときは、一度Int64型に変換して、これをBitConverter.Int64BitsToDoubleメソッドでdouble型に変換する
var v = Marshal.ReadInt64(structFuga.data, i * sizeof(double));
Console.WriteLine("data[{0}] = {1}", i, BitConverter.Int64BitsToDouble(v));
}
}
catch (Exception ex)
{
System.Diagnostics.Debug.WriteLine(ex);
}
finally
{
// 必ずメモリを解放する
Marshal.FreeHGlobal(sample06_a);
}

Console.ReadKey();
}
}
}
</source>
 
DllImport属性には、DLLファイルのパスを指定する以外に次のような引数を与えることもできる。 
これ他にも細かい設定をするための引数が用意されているので、DllImportAttributeクラスで検索すること。 
{| class="wikitable"
|-
! 名称 !! 説明
|-
| CallingConvention || エントリポイントの呼び出し規約を明示的に指定できる。 指定なしの場合は__stdcallとなる。
|-
| CharSet || 文字列パラメータをメソッドにマーシャリングし、名前マングルを制御する方法を指定する。 文字コードの相互変換する時に指定する。
|-
| EntryPoint || 呼び出すDLLエントリポイントの名前または序数を指定する。 DLLの関数名とC#上で使用する関数名を異なる名前にする時に指定する。
|}
 

__FORCETOC__
[[カテゴリ:C_Sharp]]

ライブラリの基礎 - C++DLL

2019-12-05T05:31:38Z

192.168.1.17: /* サンプルコード */

== 概要 ==
C# EXEからC++ DLLへ様々なデータ型の変数を渡したいときがある。 
 
例えば、C++ DLLから次のような関数がエクスポートされているとする。 
<source lang="c++">
void WINAPI ConvertToShort(char *pstr, short *pret);
</source>
 
上記の関数において、C# EXEから使用するときは、char*型は文字列なのでstring型を渡す。 
short*型はIntPtr型を渡す。(IntPtr型は汎用ポインタを表す型であり、void*型とほぼ同義) 
 
但し、C#は厳しい型付け言語なので、曖昧さを解決するために変換メソッドを経由する必要がある。 
具体的には、IntPtr型の変数にMarshal.AllocHGlobal関数で必要なサイズのメモリを確保して、それをC++ DLLに渡した後、 
Marshal.ReadInt16関数(型によって異なる)等で変換した後、確保したメモリをMarshal.FreeHGlobal関数で解放するというプロセスを経る必要がある。 
 

== サンプルコード ==
下記に、C++ DLLを呼ぶC# EXEのソースコードを記載する。 
<source lang="c#">
// DllImportを使用するために必要
using System.Runtime.InteropServices;

[DllImport("DrsUtil.dll", EntryPoint = "ConvertToShort")]
extern static void _ConvertToShort(string pstr, IntPtr pret); //呼び出し元の名前変えちゃう

public static short ConvertToShort(string str)
{
IntPtr buffer = new IntPtr();
buffer = Marshal.AllocHGlobal(2); // 2バイトのメモリ確保
_ConvertToShort(str, buffer); // C++/DLLの関数を呼ぶ
short sval = Marshal.ReadInt16(buffer); // 変換
Marshal.FreeHGlobal(buffer); // メモリ開放
return sval;
}
</source>
 
IntPtr型の変数は様々なものが入るので、例えば、構造体を取得することも可能だが、C# EXEで構造体を定義しなければいけない。 
WindowsのDLL(Win32 API)と.NET Frameworkでは型の管理方法が違うため、実際には型の相互変換(マーシャリング)が行われる。 
尚、BOOL型の実体はLONG型と同じなので、boolの代わりにintを指定することも可能である。 
 
<center>'''表1. Win32 APIでの型名と対応するC#の型'''</center>
<center>
{| class="wikitable"
|-
! APIの型名 (括弧内は対応するC言語の型) !! 対応するC#の型 (括弧内は.NET Frameworkでの型名) !! 備考
|-
| HANDLE (void *) || System.IntPtr System.UIntPtr || x86は4バイト x64は8バイト
|-
| BYTE (unsigned char) || byte (System.Byte) ||
|-
| SHORT (short) || short (System.Int16) ||
|-
| WORD (unsigned short) || ushort (System.UInt16) ||
|-
| INT (int) LONG (long) || int (System.Int32) ||
|-
| UINT (unsigned int) DWORD, ULONG (unsigned long) || uint (System.UInt32) ||
|-
| BOOL (long) || bool (System.Boolean) ||
|-
| CHAR (char) || 文字を渡すとき char (System.Char) 文字を受け取るとき StringBuilder ||
|-
| WCHAR(wchar_t) || 文字を渡すとき char (System.Char) 文字を受け取るとき StringBuilder ||
|-
| LPSTR (char *, char[]) LPWSTR (wchar_t *, wchar_t[]) || 文字を渡すとき string (System.String) 文字を受け取るとき System.Text.StringBuilder ||
|-
| LPCSTR (const char *, const char[]) LPCWSTR (const wchar_t *, const wchar_t[]) || 文字を渡すとき string (System.String) 文字を受け取るとき System.Text.StringBuilder ||
|-
| FLOAT (float) || float (System.Single) ||
|-
| DOUBLE (double) || double (System.Double) ||
|}
</center>
 

== サンプルコード ==
C++ DLLの作成方法は[[DLLを作成する(MFC)|コチラを参照]]する。 
下記にもC++ DLLを記述する。 
<source lang="c++">
SampleDLL.h

double __stdcall SampleFunc01(int a);
void __stdcall SampleFunc02(int a, char *pstr)
void __stdcall SampleFunc03(int a, char *pstr)
void __stdcall SampleFunc04(SampleStruct st)
void __stdcall SampleFunc05(SampleStruct *pStructure)
</source>
<source lang="c++">
SampleDll.cpp

#include <stdio.h>
#include <string.h>
#include "SampleDll.h"

typedef struct tagSampleStruct
{
int index;
char name[128];
int data[50];
} SampleStruct, *pSampleStruct;

typedef struct tagSampleStruct2
{
int length;
double *data;
} SampleStruct2, *pSampleStruct2;

double __stdcall SampleFunc01(int a)
{
printf(--<SampleDll:SampleFunc01>--\r\n");
printf("a = %d\r\n", a);
printf("---------------------------\r\n");

return 3.14;
}

void __stdcall SampleFunc02(int a, char *pstr)
{
printf("--<SampleDll:SampleFunc02>--\r\n");
printf("[%d] %s\r\n", a, str);
printf("-----------------------------\r\n");
}

void __stdcall SampleFunc03(int a, char *pstr)
{
printf("--<SampleDll:SampleFunc03>--\r\n");
printf("[%d] %s\r\n", a, str);
sprintf_s(str, 256, "C++ DLL側から文字列を返す場合は、StringBuilderクラスを使用する");
printf("------------------------\r\n");
}

void __stdcall SampleFunc04(SampleStruct st)
{
printf("--<SampleDll:Sample04>--\r\n");
printf("index = %d\r\n", st.index);
printf("name = %s\r\n", st.name);
printf("data[0] = %d, data[1] = %d, data[2] = %d, data[3] = %d\r\n", st.data[0], st.data[1], st.data[2], st.data[3]);
printf("------------------------\r\n");
}

void __stdcall SampleFunc05(SampleStruct2 *pStructure)
{
dData[256] = {0};
printf("--<SampleDll:Sample05>--\r\n");
memset(pStructure, 0, sizeof(SampleStruct2));
pStructure->length = 10;
pStructure->data = dData;
for(int i = 0; i < pStructure->length; i++)
{
dData[i] = (i + 1) / 10.0;
}
printf("------------------------\r\n");
}
</source>
<source lang="c++">
SampleDll.def // モジュール定義ファイル

LIBRARY SampleDll

EXPORTS
; 公開する関数名をリストアップ
SampleFunc01 @1
SampleFunc02 @2
SampleFunc03 @3
SampleFunc04 @4
SampleFunc05 @5
</source>
 
次に、C# EXE側でC++ DLLを呼び出す方法を記述する。 
文字列をC++ DLL側に渡す場合は、string型を使用する。 
文字列をC++ DLL側から返す場合は、string型ではなくStringBuilderクラスを使用する必要がある。 
StringBuilderクラスは受け渡しの両方が可能なので、文字列はStringBuilderクラスを使用すべきである。 
 
C++では構造体のサイズはコンパイル時に決定されるが、C#では実行時に決定される。 
したがって、C#側で構造体のサイズを予め指定する必要がある。 
この場合、構造体は固定長サイズとなるため、配列などを定義する場合は異なるサイズの配列を後からインスタンス化することができなくなる。 
 
構造体をC++ DLL側から返す場合、IntPtr型からdouble型の配列を取得するときは、一度Int64型に変換し、これをBitConverter.Int64BitsToDouble()メソッドでdouble型に変換する。 
<source lang="c#">
using System;
using System.Text;
using System.Runtime.InteropServices;

namespace SampleEXE
{
class Program
{
/// <summary>
/// 最も基本的な関数のインポート例
/// </summary>
/// <param name="a">4 バイト符号付き整数を指定します。</param>
/// <returns>倍精度浮動小数を返します。</returns>
[DllImport("SampleDLL.dll")]
private static extern double SampleFunc01(int a);

[DllImport("SampleDLL.dll", CharSet = CharSet.Unicode)]
// C++ DLL側の文字コードがUnicodeの場合は"CharSet = CharSet.Unicode"と明示的に指定する
private static extern void SampleFunc02(int a, string str);

[DllImport("SampleDLL.dll", CharSet = CharSet.Unicode)]
// C++ DLL側の文字コードがUnicodeの場合は"CharSet = CharSet.Unicode"と明示的に指定する
private static extern void SampleFunc03(int a, StringBuilder str);

/// <summary>
/// 構造体を引数に持つ関数のインポート例
/// </summary>
/// <param name="st">DLL 側に渡す構造体を指定します</param>
[DllImport("SampleDLL.dll")]
private static extern void SampleFunc04(SampleStruct st);

/// <summary>
/// DLL側からメンバにポインタを含む構造体を受け取る関数のインポート例
/// </summary>
/// <param name="pst">受け渡す構造体の先頭アドレスを示すポインタを指定する</param>
[DllImport("SampleDLL.dll")]
private static extern void SampleFunc05(IntPtr pst);

/// <summary>
/// DLLとの取り合いのために定義する構造体
/// LayoutKind.Sequentialを指定することで、C/C++同様、変数の宣言順通りにメモリに配置されるようになる
/// </summary>
[StructLayout(LayoutKind.Sequential)]
private struct SampleStruct
{
/// <summary>
/// 4バイト符号付整数
/// </summary>
[MarshalAs(UnmanagedType.I4)]
public int index;

/// <summary>
/// 固定長文字配列(SizeConstは配列のサイズを示す)
/// </summary>
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 128)]
public string name;

/// <summary>
/// 固定長配列(SizeConstは配列の要素数を示す)
/// </summary>
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 50)]
public int[] data;
}

/// <summary>
/// DLLとの取り合いのために定義する構造体
/// LayoutKind.Sequentialを指定することで、C/C++同様、変数の宣言順通りにメモリに配置されるようにする
/// </summary>
[StructLayout(LayoutKind.Sequential)]
private struct SampleStruct2
{
public int length;
public IntPtr data;
}
　
static void Main(string[] args)
{
var dRet= SampleFunc01(1);
Console.WriteLine(dRet);
Console.WriteLine();

var str = "string型で文字列を渡すことができます。";
SampleFunc02(2, str);

var strb = new System.Text.StringBuilder(256);
strb.Append("文字列のバッファを渡す場合は StringBuilder クラスで受け渡します。");
SampleFunc03(3, strb);
Console.WriteLine(strb);

var structHoge = new SampleStruct()
{
index = 4,
name = "構造体サンプル",
data = new int[50],
};

structHoge.data[0] = 11;
structHoge.data[1] = 22;
structHoge.data[2] = 33;
SampleFunc04(structHoge);

// SampleStruct2構造体のサイズを取得する
// 指定サイズ分だけメモリ領域を確保して、その先頭アドレスをstructPiyoに格納する
var structPiyo = Marshal.AllocHGlobal(Marshal.SizeOf(typeof(SampleStruct2)));
try
{
SampleFunc05(structPiyo);
// 受け取ったstructPiyoからSampleStruct2構造体の情報に構築し直す
var structFuga = (SampleStruct2)Marshal.PtrToStructure(structPiyo, typeof(SampleStruct2));
for (int i = 0; i < structFuga.length; i++)
{
var v = Marshal.ReadInt64(structFuga.data, i * sizeof(double));
Console.WriteLine("data[{0}] = {1}", i, BitConverter.Int64BitsToDouble(v));
}
}
catch (Exception ex)
{
System.Diagnostics.Debug.WriteLine(ex);
}
finally
{
// 必ずメモリを解放する
Marshal.FreeHGlobal(sample06_a);
}

Console.ReadKey();
}
}
}
</source>
 
DllImport属性には、DLLファイルのパスを指定する以外に次のような引数を与えることもできる。 
これ他にも細かい設定をするための引数が用意されているので、DllImportAttributeクラスで検索すること。 
{| class="wikitable"
|-
! 名称 !! 説明
|-
| CallingConvention || エントリポイントの呼び出し規約を明示的に指定できる。 指定なしの場合は__stdcallとなる。
|-
| CharSet || 文字列パラメータをメソッドにマーシャリングし、名前マングルを制御する方法を指定する。 文字コードの相互変換する時に指定する。
|-
| EntryPoint || 呼び出すDLLエントリポイントの名前または序数を指定する。 DLLの関数名とC#上で使用する関数名を異なる名前にする時に指定する。
|}
 

__FORCETOC__
[[カテゴリ:C_Sharp]]

ライブラリの基礎 - C++DLL

2019-11-21T18:00:21Z

192.168.1.17: /* サンプルコード */

== 概要 ==
C# EXEからC++ DLLへ様々なデータ型の変数を渡したいときがある。 
 
例えば、C++ DLLから次のような関数がエクスポートされているとする。 
<source lang="c++">
void WINAPI ConvertToShort(char *pstr, short *pret);
</source>
 
上記の関数において、C# EXEから使用するときは、char*型は文字列なのでstring型を渡す。 
short*型はIntPtr型を渡す。(IntPtr型は汎用ポインタを表す型であり、void*型とほぼ同義) 
 
但し、C#は厳しい型付け言語なので、曖昧さを解決するために変換メソッドを経由する必要がある。 
具体的には、IntPtr型の変数にMarshal.AllocHGlobal関数で必要なサイズのメモリを確保して、それをC++ DLLに渡した後、 
Marshal.ReadInt16関数(型によって異なる)等で変換した後、確保したメモリをMarshal.FreeHGlobal関数で解放するというプロセスを経る必要がある。 
 

== サンプルコード ==
下記に、C++ DLLを呼ぶC# EXEのソースコードを記載する。 
<source lang="c#">
// DllImportを使用するために必要
using System.Runtime.InteropServices;

[DllImport("DrsUtil.dll", EntryPoint = "ConvertToShort")]
extern static void _ConvertToShort(string pstr, IntPtr pret); //呼び出し元の名前変えちゃう

public static short ConvertToShort(string str)
{
IntPtr buffer = new IntPtr();
buffer = Marshal.AllocHGlobal(2); // 2バイトのメモリ確保
_ConvertToShort(str, buffer); // C++/DLLの関数を呼ぶ
short sval = Marshal.ReadInt16(buffer); // 変換
Marshal.FreeHGlobal(buffer); // メモリ開放
return sval;
}
</source>
 
IntPtr型の変数は様々なものが入るので、例えば、構造体を取得することも可能だが、C# EXEで構造体を定義しなければいけない。 
WindowsのDLL(Win32 API)と.NET Frameworkでは型の管理方法が違うため、実際には型の相互変換(マーシャリング)が行われる。 
尚、BOOL型の実体はLONG型と同じなので、boolの代わりにintを指定することも可能である。 
 
<center>'''表1. Win32 APIでの型名と対応するC#の型'''</center>
<center>
{| class="wikitable"
|-
! APIの型名 (括弧内は対応するC言語の型) !! 対応するC#の型 (括弧内は.NET Frameworkでの型名) !! 備考
|-
| HANDLE (void *) || System.IntPtr System.UIntPtr || x86は4バイト x64は8バイト
|-
| BYTE (unsigned char) || byte (System.Byte) ||
|-
| SHORT (short) || short (System.Int16) ||
|-
| WORD (unsigned short) || ushort (System.UInt16) ||
|-
| INT (int) LONG (long) || int (System.Int32) ||
|-
| UINT (unsigned int) DWORD, ULONG (unsigned long) || uint (System.UInt32) ||
|-
| BOOL (long) || bool (System.Boolean) ||
|-
| CHAR (char) || 文字を渡すとき char (System.Char) 文字を受け取るとき StringBuilder ||
|-
| WCHAR(wchar_t) || 文字を渡すとき char (System.Char) 文字を受け取るとき StringBuilder ||
|-
| LPSTR (char *, char[]) LPWSTR (wchar_t *, wchar_t[]) || 文字を渡すとき string (System.String) 文字を受け取るとき System.Text.StringBuilder ||
|-
| LPCSTR (const char *, const char[]) LPCWSTR (const wchar_t *, const wchar_t[]) || 文字を渡すとき string (System.String) 文字を受け取るとき System.Text.StringBuilder ||
|-
| FLOAT (float) || float (System.Single) ||
|-
| DOUBLE (double) || double (System.Double) ||
|}
</center>
 

== サンプルコード ==
C++ DLLの作成方法は[[DLLを作成する(MFC)|コチラを参照]]する。 
下記にもC++ DLLを記述する。 
<source lang="c++">
SampleDLL.h

double __stdcall SampleFunc01(int a);
void __stdcall SampleFunc02(int a, char *pstr)
void __stdcall SampleFunc03(int a, char *pstr)
void __stdcall SampleFunc04(SampleStruct st)
void __stdcall SampleFunc05(SampleStruct *pStructure)
</source>
<source lang="c++">
SampleDll.cpp

#include <stdio.h>
#include <string.h>
#include "SampleDll.h"

typedef struct tagSampleStruct
{
int index;
char name[128];
int data[50];
} SampleStruct, *pSampleStruct;

typedef struct tagSampleStruct2
{
int length;
double *data;
} SampleStruct2, *pSampleStruct2;

double __stdcall SampleFunc01(int a)
{
printf(--<SampleDll:SampleFunc01>--\r\n");
printf("a = %d\r\n", a);
printf("---------------------------\r\n");

return 3.14;
}

void __stdcall SampleFunc02(int a, char *pstr)
{
printf("--<SampleDll:SampleFunc02>--\r\n");
printf("[%d] %s\r\n", a, str);
printf("-----------------------------\r\n");
}

void __stdcall SampleFunc03(int a, char *pstr)
{
printf("--<SampleDll:SampleFunc03>--\r\n");
printf("[%d] %s\r\n", a, str);
sprintf_s(str, 256, "C++ DLL側から文字列を返す場合は、StringBuilderクラスを使用する");
printf("------------------------\r\n");
}

void __stdcall SampleFunc04(SampleStruct st)
{
printf("--<SampleDll:Sample04>--\r\n");
printf("index = %d\r\n", st.index);
printf("name = %s\r\n", st.name);
printf("data[0] = %d, data[1] = %d, data[2] = %d, data[3] = %d\r\n", st.data[0], st.data[1], st.data[2], st.data[3]);
printf("------------------------\r\n");
}

void __stdcall SampleFunc05(SampleStruct2 *pStructure)
{
dData[256] = {0};
printf("--<SampleDll:Sample05>--\r\n");
memset(pStructure, 0, sizeof(SampleStruct2));
pStructure->length = 10;
pStructure->data = dData;
for(int i = 0; i < pStructure->length; i++)
{
dData[i] = (i + 1) / 10.0;
}
printf("------------------------\r\n");
}
</source>
<source lang="c++">
SampleDll.def // モジュール定義ファイル

LIBRARY SampleDll

EXPORTS
; 公開する関数名をリストアップ
SampleFunc01 @1
SampleFunc02 @2
SampleFunc03 @3
SampleFunc04 @4
SampleFunc05 @5
</source>
 
次に、C# EXE側でC++ DLLを呼び出す方法を記述する。 
文字列をC++ DLL側に渡す場合は、string型を使用する。 
文字列をC++ DLL側から返す場合は、string型ではなくStringBuilderクラスを使用する必要がある。 
StringBuilderクラスは受け渡しの両方が可能なので、文字列はStringBuilderクラスを使用すべきである。 
 
C++では構造体のサイズはコンパイル時に決定されるが、C#では実行時に決定される。 
したがって、C#側で構造体のサイズを予め指定する必要がある。 
この場合、構造体は固定長サイズとなるため、配列などを定義する場合は異なるサイズの配列を後からインスタンス化することができなくなる。 
 
構造体をC++ DLL側から返す場合、IntPtr型からdouble型の配列を取得するときは、一度Int64型に変換し、これをBitConverter.Int64BitsToDouble()メソッドでdouble型に変換する。 
<source lang="c#">
using System;
using System.Text;
using System.Runtime.InteropServices;

namespace SampleEXE
{
class Program
{
/// <summary>
/// 最も基本的な関数のインポート例
/// </summary>
/// <param name="a">4 バイト符号付き整数を指定します。</param>
/// <returns>倍精度浮動小数を返します。</returns>
[DllImport("SampleDLL.dll")]
private static extern double SampleFunc01(int a);

[DllImport("SampleDLL.dll", CharSet = CharSet.Unicode)]
// C++ DLL側の文字コードがUnicodeの場合は"CharSet = CharSet.Unicode"と明示的に指定する
private static extern void SampleFunc02(int a, string str);

[DllImport("SampleDLL.dll", CharSet = CharSet.Unicode)]
// C++ DLL側の文字コードがUnicodeの場合は"CharSet = CharSet.Unicode"と明示的に指定する
private static extern void SampleFunc03(int a, StringBuilder str);

/// <summary>
/// 構造体を引数に持つ関数のインポート例
/// </summary>
/// <param name="st">DLL 側に渡す構造体を指定します</param>
[DllImport("SampleDLL.dll")]
private static extern void SampleFunc04(SampleStruct st);

/// <summary>
/// DLL側からメンバにポインタを含む構造体を受け取る関数のインポート例
/// </summary>
/// <param name="pst">受け渡す構造体の先頭アドレスを示すポインタを指定する</param>
[DllImport("SampleDLL.dll")]
private static extern void SampleFunc05(IntPtr pst);

/// <summary>
/// DLLとの取り合いのために定義する構造体
/// LayoutKind.Sequentialを指定することで、C/C++同様、変数の宣言順通りにメモリに配置されるようになる
/// </summary>
[StructLayout(LayoutKind.Sequential)]
private struct SampleStruct
{
/// <summary>
/// 4バイト符号付整数
/// </summary>
[MarshalAs(UnmanagedType.I4)]
public int index;

/// <summary>
/// 固定長文字配列(SizeConstは配列のサイズを示す)
/// </summary>
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 128)]
public string name;

/// <summary>
/// 固定長配列(SizeConstは配列の要素数を示す)
/// </summary>
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 50)]
public int[] data;
}

/// <summary>
/// DLLとの取り合いのために定義する構造体
/// LayoutKind.Sequentialを指定することで、C/C++同様、変数の宣言順通りにメモリに配置されるようにする
/// </summary>
[StructLayout(LayoutKind.Sequential)]
private struct SampleStruct2
{
public int length;
public IntPtr data;
}
　
static void Main(string[] args)
{
var dRet= SampleFunc01(1);
Console.WriteLine(dRet);
Console.WriteLine();

var str = "string型で文字列を渡すことができます。";
SampleFunc02(2, str);

var strb = new System.Text.StringBuilder(256);
strb.Append("文字列のバッファを渡す場合は StringBuilder クラスで受け渡します。");
SampleFunc03(3, strb);
Console.WriteLine(strb);

var structHoge = new SampleStruct()
{
index = 4,
name = "構造体サンプル",
data = new int[50],
};

structHoge.data[0] = 11;
structHoge.data[1] = 22;
structHoge.data[2] = 33;
SampleFunc04(structHoge);

var structPiyo = Marshal.AllocHGlobal(Marshal.SizeOf(typeof(SampleStruct2)));
try
{
SampleFunc05(structPiyo);
var structFuga = (SampleStruct2)Marshal.PtrToStructure(structPiyo, typeof(SampleStruct2));
for (int i = 0; i < structFuga.length; i++)
{
var v = Marshal.ReadInt64(structFuga.data, i * sizeof(double));
Console.WriteLine("data[{0}] = {1}", i, BitConverter.Int64BitsToDouble(v));
}
}
catch (Exception ex)
{
System.Diagnostics.Debug.WriteLine(ex);
}
finally
{
// 必ずメモリを解放する
Marshal.FreeHGlobal(sample06_a);
}

Console.ReadKey();
}
}
}
</source>
 
DllImport属性には、DLLファイルのパスを指定する以外に次のような引数を与えることもできる。 
これ他にも細かい設定をするための引数が用意されているので、DllImportAttributeクラスで検索すること。 
{| class="wikitable"
|-
! 名称 !! 説明
|-
| CallingConvention || エントリポイントの呼び出し規約を明示的に指定できる。 指定なしの場合は__stdcallとなる。
|-
| CharSet || 文字列パラメータをメソッドにマーシャリングし、名前マングルを制御する方法を指定する。 文字コードの相互変換する時に指定する。
|-
| EntryPoint || 呼び出すDLLエントリポイントの名前または序数を指定する。 DLLの関数名とC#上で使用する関数名を異なる名前にする時に指定する。
|}
 

__FORCETOC__
[[カテゴリ:C_Sharp]]

ライブラリの基礎 - C++DLL

2019-10-31T04:14:14Z

192.168.1.17: /* サンプルコード */