TURN relay server performance: load balance and network optimization

이번 포스트는 위 사이트의 내용을 구글 번역기를 통해서 정리해둔 내용입니다.

TURN 릴레이 서버 성능: 부하 분산 및 네트워크 최적화

이 TURN 서버는 node.js 및 nginx에서 사용하는 것과 유사한 혼합 작업 모델을 사용합니다. 비동기 IO는 다중 CPU 하드웨어를 활용하기 위해 스레딩 모델과 결합됩니다. 스레드 수는 제한되어 있고(CPU 수에 가까움) 리소스 소비가 최적입니다. 많은 클라이언트 연결을 동시에 처리할 수 있습니다. TURN 서버는 epoll(Linux), kqueue(BSD 및 Mac OS X), 이벤트 포트(Solaris), poll(Cygwin) 또는 select를 통해 운영 체제에 새 이벤트가 발생할 때 알림을 받아야 한다고 알려줍니다. 새 패킷이 도착하거나 새 타이머 이벤트가 발생하면 TURN 서버가 깨어나서 콜백을 실행합니다. 각 이벤트별 작업은 매우 짧기 때문에 시스템은 거의 실시간에 가까운 반응 시간을 갖습니다(효율적인 미디어 트래픽 처리에 필요함).

물론 많은 TURN 세션이 관련된 고부하 시나리오에서 턴서버 프로세스는 사실상 휴면 시간이 없으며 세미 풀 모드로 작동합니다.

비교적 장기적인 작업(데이터베이스 상호 작용, CLI 처리)의 경우 TURN 서버는 별도의 스레드를 사용하므로 트래픽 처리 처리는 더 긴 작업의 영향을 받지 않습니다.

시스템은 효율성과 이식성을 위해 C 언어로 구현됩니다. IO 및 타이머 이벤트 다중화를 위해 libevent2 라이브러리가 사용됩니다.

TURN 서버는 또한 네트워크 프로토콜 서버에 특정한 몇 가지 최적화를 통합합니다. 예를 들어 "풀" 처리의 일부 요소가 포함됩니다(일반적인 "푸시" 접근 방식과 반대).

각 TURN 세션(할당)은 비교적 적은 리소스를 소비합니다.

• 할당에는 자체 스레드나 프로세스가 없습니다.
• 할당은 일반적으로 동일한 스레드 내에 유지되므로 컨텍스트 전환 및 잠금이 줄어듭니다.
• 할당은 다른 할당과 많은 시스템 리소스를 공유합니다.

물론 TURN 세션에는 여전히 리소스가 필요하며 여전히 CPU 전력과 네트워크 처리량을 소비합니다. 각 시스템은 규모에 상관없이 여전히 제한된 수의 TURN 할당(수천 또는 수만 개의 일반 트래픽 스트림)을 처리할 수 있습니다. 이 문서는 그 수를 최대화하는 것에 관한 것입니다.

최대 동시 세션 수에 영향을 미치는 사항:

• 미디어 그룹 :

  1. 사용할 코덱(페이로드 크기).
  2. 패킷 간격.

• 네트워크 위상 및 프로토콜 그룹

  1. ISP 퍼포먼스
  2. P2P 세션
  3. 관련 프로토콜 (TCP, UDP 또는 TLS)
  4. TLS가 관련된 경우 TLS 세션의 매개변수(무거운 정도)
  5. 클라이언트가 밸런싱을 위해 서버의 300오류(리다이렉션)를 대체할 수 있는지 여부(WebRTC 클라이언트는 현재 불가능).
  6. 라운드로빈 DNS 방식을 사용할 수 있는가?

• 하드웨어, OS 및 소프트웨어 설정 그룹

  1. NIC 수
  2. How advanced are the NICs.
  3. 시스템 메모리 및 버스 성능(많은 트래픽이 통과함).
  4. CPU 수 및 CPU 성능(캐시 등).
  5. OS 유형 및 버전.
  6. NIC가 OS와 얼마나 잘 통합되어 있는지(드라이버가 전체 NIC 기능을 사용하는지 여부).
  7. 시스템이 처리할 수 있는 파일 설명자 수(전체 및 프로세스당 제한). 일반적으로 이것은 ulimit 시스템 매개변수입니다. 프로세스별 및 시스템 전체 ulimit를 늘리는 방법은 시스템 설명서를 참조하십시오. 각 TURN 할당은 적어도 1개 이상의 파일 디스크립터를 사용합니다(서로 다른 유형의 세션은 다른 수의 파일 디스크립터를 사용하고 다른 네트워크 엔진은 이와 관련하여 다르게 작동합니다). 시스템 제한이 허용하는 것보다 더 많은 세션을 열려고 하면 TURN 서버 콘솔이나 로그 파일에 "Too many open files"와 같은 오류가 표시됩니다.

데이터베이스 최적화

• 가장 빠른 데이터베이스 옵션은 SQLite입니다. 프로세스 간 또는 네트워크 통신이 필요하지 않기 때문에 데이터베이스 관리 라이브러리가 TURN 서버 프로세스에 직접 연결됩니다. 그러나 다음과 같은 경우 더 강력한 데이터베이스 관리 시스템(예: PostgreSQL, MySQL, Redis 또는 MongoDB)이 필요할 수 있습니다.

  1. 데이터베이스는 수천 개 이상의 레코드입니다.
  2. 추가 보안이 필요한 경우
  3. 다른 프로세스가 TURN 서버와 동시에 TURN 데이터베이스에 능동적으로 액세스하려는 경우;
  4. 데이터베이스가 여러 TURN 서버에서 공유되는 경우.

• 간결하고 단순한 설정에서 SQLite는 가장 간단하고 빠른 옵션입니다.

네트워크 운영 성능 최적화

TURN 서버 성능은 운영 체제가 TCP/IP 스택 작업을 얼마나 효율적으로 처리하는지에 따라 크게 달라집니다. 성능 최적화는 여러 접근 방식을 조합하여 달성할 수 있습니다.

• "소프트웨어 RSS": 패킷 조정(RPS)을 수신합니다.
  네트워크 카드가 RSS를 지원하지 않으면 소프트웨어에서 해당 기능을 에뮬레이트하는 OS(예: 최신 버전의 BSD 및 Linux)를 사용할 수 있습니다. RSS 및 RPS를 켜는 방법을 알아보려면 OS의 설명서를 읽으십시오. RSS 및 RPS에 대한 일반적인 설명은 다음에서 찾을 수 있습니다.

• 여러 시스템 간의 로드 밸런싱.

이것은 가장 효율적이고 가장 효율적인 성능 조정 방법입니다. 사용 가능한 시스템 수에 비례하여 거의 선형에 가까운 성능 개선이 가능합니다. 사실상 무제한 확장성을 달성할 수 있습니다.

여기에는 세 가지 옵션이 있습니다.

1. 요청을 TURN 서버 그룹의 구성원으로 리디렉션하는 네트워킹 부하 분산 장비를 설정합니다. 일반적으로 동일한 클라이언트의 일부 TURN 세션이 정보를 공유해야 하기 때문에 동일한 클라이언트 IP에서 동일한 서버로 요청을 리디렉션하는 데 주의해야 합니다. 서로 다른 TURN 세션이 상호 작용해야 하는 두 가지 경우가 있습니다. RTP/RTCP 연결 쌍(RFC 5766)과 TCP 릴레이(RFC 6062)입니다. 이러한 기능을 사용하지 않는 경우 간단한 네트워크 로드 밸런싱으로 충분합니다. 이러한 기능을 사용하는 경우 동일한 TURN 서버에 전체 클라이언트 IP(모든 네트워크 포트 포함)를 매핑해야 합니다. 또한,
2. 라운드 로빈 DNS를 사용하여 덜 복잡한 체계를 설정합니다. 클라이언트는 모든 요청을 동일한 DNS 검색 TURN 서버로 보내야 합니다. 이 체계는 모든 사용 사례를 지원합니다.
3. ALTERNATE-SERVER 옵션(--alternate-server 옵션)과 함께 내장 밸런싱 기능을 사용하십시오. 이 경우 클라이언트는 모든 요청을 동일한 대체 서버 주소로 보내야 합니다. 단일 시스템을 TURN 서버 클러스터의 "프론트 엔드"로 설정하고 해당 "로드 banacer" 시스템은 아무 작업도 수행하지 않습니다. 대체 서버 IP 주소와 함께 모든 클라이언트에 300 ALTERNATE-SERVER 오류를 반환하므로 클라이언트가 다른 서버에 다시 연결합니다. 대체 서버가 라운드 로빈 방식으로 선택되면 TURN 서버의 로드 밸런싱 클러스터가 있습니다.

• 단일 시스템 내에서 로드 밸런싱 및 최적화.

이 섹션은 주로 2.6.32-431 이전 커널이 있는 Linux 시스템 또는 3.0에서 3.8 커널을 위한 것입니다. 예를 들면 CentOS 6.4 및 Debian Wheezy가 있습니다. Cygwin 사용자도 동일한 기술을 적용할 수 있습니다.

이 섹션은 다음에 적용 되지 않습니다 .

1. ArchLinux, Debian Sid, Fedora와 같은 Linux 커널 3.9 이상이 있는 시스템;

2. 2.6 라인의 최신 Linux 커널이 있는 시스템(CentOS 6.5와 같은 2.6.32-431 이상);

3. BSD 시스템;

4. 솔라리스 시스템;

5. 맥 OS X;

   • 해당 시스템의 사용자는 이 섹션을 건너뛸 수 있습니다. 귀하의 TURN 서버 아키텍처는 귀하의 플랫폼에 대해 매우 미세하게 조정되어 있으며 이미 있는 그대로 합리적으로 최적입니다. 턴서버 프로세스가 시작되면 시스템에 가장 적합한 성능 옵션이 자동으로 선택됩니다.

이전 Linux 시스템 시스템을 사용하는 경우에도 여전히 우수한 성능을 얻을 수 있습니다. 계속 읽으십시오.

이전에 말했듯이 TURN 서버 성능은 주로 운영 체제가 TCP/IP 스택 작업을 얼마나 효율적으로 처리하는지에 달려 있습니다. 일반적으로 스택의 TCP 부분은 적절하게 최적화되지만 UDP 처리는 종종 차선책입니다. 지금까지 일반적인 UDP 스택 구현은 TURN에서 사용되는 것과 같은 "영구적인" UDP 세션에 대해 잘 조정되지 않았습니다. 예를 들어, 기본적으로 Linux 커널은 128개의 버킷에 있는 모든 UDP 소켓을 해시합니다. 수천 개의 UDP 세션이 있는 경우 비효율적으로 처리되는 UDP 소켓이 많이 있습니다.

즉, Linux 커널에서 UDP를 구현하면 해시 테이블을 사용하여 소켓 구조를 저장합니다. 이전 2.6.32 커널(예: CentOS 6.0-6.4의 기본값)에서 이 해시 테이블은 128개의 항목을 갖도록 하드코딩됩니다. 따라서 많은 수의 소켓을 사용하면 테이블의 성능이 각 수신 패킷에 대해 통과해야 하는 연결 목록으로 저하됩니다.

2.6.33 이전의 Linux 커널이 있는 경우 커널 코드에서 하드코딩된 해시 크기를 변경하고 커널을 다시 컴파일할 수 있습니다. 최신 커널이 있는 경우 커널 재컴파일 없이 이를 수행할 수 있습니다. 커널 2.6.33은 구성 가능한 UDP 해시 테이블 크기와 IP+port로 키가 지정된 두 번째 UDP 해시 테이블을 도입했습니다(이전에는 포트만 사용). "uhash_entries" 부팅 시 커널 변수를 설정하여 해시 테이블 크기를 구성할 수 있습니다(예: /etc/grub.conf에서). 최상의 성능을 위해 65536으로 설정하십시오.

다른 OS에도 비슷한 문제가 있습니다. 구성 지침은 OS 설명서를 확인하십시오.

TURN 서버는 다중 스레드 네트워크 패킷 라우팅 시스템으로 설계되었습니다. 그러나 멀티스레딩이 항상 특정 시스템 구성에 가장 적합한 옵션은 아닙니다. 기본 시작 TURN 서버 구성은 메모리, 스레드 선호도, 캐시 및 CPU 리소스 간, 그리고 TCP와 UDP 일반적인 "바닐라" OS 네트워킹 스택 구현 간의 절충안입니다. 이것은 특정 하드웨어, 특정 OS 또는 특정 로드 패턴에 맞게 조정된 특수 시스템이 아닙니다. TURN 서버 설계는 가능한 응용 프로그램의 범위가 매우 넓기 때문에 특정 플랫폼의 특정 응용 프로그램에 대해 100% 최적이 아닐 수 있습니다. 하지만 어디에서나 사용할 수 있을 만큼 충분히 좋아야 합니다.

TURN 서버 매개변수 -m을 사용하면 스레딩 구성을 조정할 수 있습니다. "-m 0" 매개변수(또는 "--relay-threads=0")를 사용하여 멀티스레딩을 끌 수 있습니다. 모든 네트워크 패킷 처리를 하나의 스레드 내에서 유지하여 컨텍스트 전환 등을 제거합니다. 이는 시스템에 더 효율적인 옵션일 수 있습니다. 인증 프로세스가 일반 패킷 라우팅을 보유하지 않아야 하기 때문에 여전히 별도의 인증 스레드가 있습니다.

"-m 0" 옵션을 사용하고 CPU 코어당 하나씩 시스템에서 여러 TURN 서버를 실행할 수 있습니다. 그것은 아마도 확장성 측면에서 최고의 성능 옵션일 것입니다. 각 TURN 서버에는 자체 네트워크 수신 주소와 자체 중계 IP 및/또는 중계 포트 범위가 있어야 하므로 구성이 복잡하지만 성능은 최고가 될 것입니다. ALTERNATE-SERVER 메커니즘을 사용하여 전체 "팩"을 외부 세계에 단일 "초기" TURN 서버 프런트 엔드로 표시할 수 있습니다.

• 효율적인 이벤트 다중화

대규모 TURN 서버의 경우 다중 소켓을 효율적으로 처리하는 것이 가장 심각한 문제가 될 수 있습니다. TURN 서버는 이를 위해 libevent2 도구를 사용합니다. Libevent2는 현재 플랫폼에서 사용 가능한 가장 효율적인 이벤트 다중화 기능을 활용합니다. * Linux: epoll * BSD 및 Mac OS X: kqueue * Solaris: 이벤트 포트 * Cygwin: poll

이러한 기능 중에서 kqueue는 아마도 가장 발전된 것입니다.

따라서 엄청난 수의 소켓이 있는 경우 BSD 시스템은 특히 TCP 프로토콜 성능이 중요한 경우 매력적인 옵션이 될 수 있습니다. 예를 들어 DragonFlyBSD는 성능 지향적인 BSD 변형입니다. FreeBSD도 좋은 선택입니다.

클라이언트 트래픽이 대부분 UDP(또는 DTLS)를 사용하는 경우 최신 Linux 커널 버전(Google 네트워킹 패치 포함)이 유리할 수 있습니다. 최근 Linux 커널은 몇 개의 "프론트 엔드" 소켓을 통해 다중 스레드 환경에서 UDP 처리를 허용합니다(동일한 스레드에 속한 모든 세션은 동일한 UDP 소켓을 공유합니다). 소켓 수가 적을수록 이벤트 다중화 라이브러리에 의한 트래픽 처리가 더 효율적입니다. 따라서 Google 커널 패치가 있는 시스템은 가장자리가 있습니다(작성 ​​당시 CentOS 6.5, ArchLinux 및 Fedora).

모든 유형의 다양한 로드를 포함하는 우리의 결합된 테스트는 일반적으로 FreeBSD 9.x와 DragonflyBSD가 TURN 서버용 플랫폼으로서 최고의 성능을 보인다는 것을 보여줍니다. 그 이유를 분석하는 것은 매우 어렵습니다. 그러나 마일리지는 다를 수 있습니다.

Centos8에 PHP 설치하기

PHP 7.4 설치

EPEL 저장소 추가

$ sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

remi 저장소 추가

WebTatic 은 아직 CentOS 8 을 지원하지 않으므로 remi 저장소를 추가합니다

$ sudo dnf install https://rpms.remirepo.net/enterprise/remi-release-8.rpm

module 활성화

dnf module 명령어로 현재 사용 가능한 php 의 버전을 확인할 수 있습니다.

dnf module

$ sudo dnf module list php 

Last metadata expiration check: 0:01:22 ago on Tue 05 May 2020 08:44:37 AM EDT.
CentOS-8 - AppStream
Name                            Stream                              Profiles                                             Summary                                         
php                             7.2 [d]                             common [d], devel, minimal                           PHP scripting language                          
php                             7.3 [e]                             common, devel, minimal                               PHP scripting language                          

Remi's Modular repository for Enterprise Linux 8 - x86_64
Name                            Stream                              Profiles                                             Summary                                         
php                             remi-7.2                            common [d], devel, minimal                           PHP scripting language                          
php                             remi-7.3                            common [d], devel, minimal                           PHP scripting language                          
php                             remi-7.4                            common [d], devel, minimal                           PHP scripting language  

새로 추가된 저장소인 remi 에서 제공하는 remi-7.4 를 설치하면 PHP 7.4 를 사용할 수 있습니다.

remi-7.4 활성화

먼저 module enable 명령어로 remi 저장소를 활성화해 줍니다.

$ sudo  dnf module enable php:remi-7.4

이제 dnf install 명령으로 php 를 설치하면 활성화된 remi-7.4 의 버전이 설치됩니다.

$ sudo  dnf install php php-fpm php-intl php-mbstring php-pdo php-xml php-gd php-mysqlnd php-zip

"Failed to set locale" 에러 발생시

# localectl set-locale LANG=ko_KR.UTF-8
or
# localectl set-locale LANG=en_KR.UTF-8
# yum search langpacks*
~~

Language Pack 설치

# dnf install langpacks-en langpacks-kr  
# dnf install glibc-langpack-en glibc-langpack-ko  
or
# dnf install glibc-all-langpacks

# dnf search glibc-langpack-en glibc-langpack-ko

1. Coturn 패키지 설치

$ apt-get install coturn

2. Coturn 서버 구성 파일 준비

turnserver.conf 파일을 찾습니다. 일반적으로 다음과 같습니다. /etc/turnserver.conf

/etc/turnserver.conf 파일을 사용할 수 없지만 예를 들어 /usr/local/etc/turnserver.conf.default 파일이 있으면 /usr/local/etc 에 복사합니다.

$ cp -p usr / local / etc / turnserver.conf.default /usr/local/etc/turnserver.conf

기본적으로 Coturn은 STUN/TURN 서버처럼 작동합니다.

TURN 서버로 작동하게 하려면 /usr/local/etc/turnserver.conf만 편집하고 이 키의 주석을 제거하십시오.

no-stun

이 예는 기본 설정을 사용합니다. 즉, Coturn 서버는 STUN/TURN 서버로 작동합니다.

3. Listening IP 설정

기본적으로 Coturn 서버는 모든 시스템 IP에서 수신 대기합니다.
(NoMachine 서버 구성에서 이러한 IP를 지정할 수 있습니다. 타사솔루션 이므로 제외)

Coturn 서버의 IP를 입력합니다.

listening-ip = 10.x.x.x
이 예에서는 다음을 사용합니다. Listening-ip=172.17.19.101

• relay-ip 옵션이 있다면 마찬가지로 공인IP 를 입력해줍니다.

relay-ip = 10.x.x.x

4. Coturn 서버에 접속하기 위한 사용자 이름과 비밀번호 설정

본적으로 Coturn 서버에는 인증 설정이 없으므로 액세스하기 위해 사용자 이름과 암호를 설정하는 것이 좋습니다.

/usr/local/etc/turnserver.conf를 편집하고 이 키에 사용자 이름과 암호를 설정합니다.

사용자=사용자 이름:비밀번호

이러한 자격 증명은 (넥스트클라우드같은 솔루션) 서버 구성에서 지정해야 합니다.

이 예에서는 다음을 설정합니다.

[형식] user = 사용자이름 : 암호

user=testuser:usertest

5. Listening Port 설정

UDP 및 TCP의 기본 리스너 포트는 다음과 같습니다.

listening-port = 3478

tls-listening-port = 5349

이 포트는 STUN 및 TURN 모두 동일합니다. TURN 은 연결 및 트래픽 릴레이에 기본 포트 범위 49152-65535를 사용합니다.

엄격한 NAT를 사용하기 위해 포트를 80 또는 443으로 변경할 수 있으므로 Coturn 서버의 공식 설명서 ( https://github.com/coturn/coturn/wiki/turnserver) 를 참조하는 것이 좋습니다.

이 예제에서는 기본 포트를 사용합니다.

6. WebRTC를 지원 설정

WebRTC를 지원하도록 구성하려면 Coturn 안내서 및 사용법을 참조하십시오.

이 예제에서는 /usr/local/etc/turnserver.conf 파일을 열고 아래 내용 주석해제를 합니다.

verbose

fingerprint

lt-cred-mech

realm=sysdocu.com

7. Coturn 서버 실행

turnserver &

참고로 Coturn 로그 디렉토리는 / var / log, / log /, / var / tmp, / tmp 또는 현재 디렉토리입니다.

Coturn 서버가 이제 가동 될 것입니다.

UBUNTU 에 NGINX설치

1. 서버의 패키지 목록 업데이트

sudo apt update
sudo apt upgrade

불필요한 패키지 삭제

sudo apt autoremove

2. Nginx 설치

sudo apt install nginx

제거할 경우

sudo apt remove nginx 

3. 실행

sudo service start nginx
sudo service status nginx
systemctl status nginx.service

4. Nginx Version 확인

sudo dpkg -l nginx
nginx -v

5. Nginx 경로
   apt-get을 이용하여 패키지 설치 방법을 이용하면 기본 폴더는 "/etc/nginx/"

sudo find / -name nginx.conf

nginx.conf: nginx가 동작해야 할 방식을 설정 값을 통해 지정, root 권한만 수정이 가능하다

sudo vim nginx.conf

6. nginx 구동 테스트

netstat -lntp

80번 포트가 리스닝되고 있으면 실행된 상태이다.

만약 netstat이 없다면

apt install net-tools

CentOS7 에 NginX 설치

1. yum 외부 저장소 추가

yum 저장소에 nginx가 없기 때문에 관련 저장소를 추가한다.

[root@k5w1hcd ~]# cd etc/yum.repos.d/  
[root@k5w1hcd ~ yum.repos.d]# ls CentOS-Base.repo CentOS-CR.repo CentOS-Debuginfo.repo CentOS-Media.repo CentOS-Sources.repo CentOS-Vault.repo CentOS-fasttrack.repo microsoft-prod.repo  
[root@k5w1hcd ~ yum.repos.d]# vi nginx.repo  
[root@k5w1hcd ~ yum.repos.d]#

/etc/yum.repos.d/ 경로에 nginx.repo 파일을 추가하고 아래와 같이 작성해준다다.

[nginx]  
name=nginx repo  
baseurl=http://nginx.org/packages/centos/7/$basearch/  
gpgcheck=0  
enabled=1

위 내용은 공식 사이트에 있으며, OS가 다르다면 해당 OS에 맞게 수정해 주면 된다.

2. yum install

yum install 명령어를 이용해서 설치한다.

[root@k5w1hcd ~]# yum install -y nginx

3. 방화벽 포트 개방

[root@k5w1hcd ~]#  
[root@k5w1hcd ~]#  
[root@k5w1hcd ~]# firewall-cmd --permanent --zone=public --add-port=8089/tcp  
success  
[root@k5w1hcd ~]# firewall-cmd --reload  
success  
[root@k5w1hcd ~]# firewall-cmd --list-ports  
21/tcp 5000/tcp 5001/tcp 8089/tcp  
[root@k5w1hcd ~]#  

4. Nginx 포트 설정

[root@k5w1hcd ~]# vi /etc/nginx/conf.d/default.conf  

server { 
    listen 8080;  
    server_name localhost;  
    #charset koi8-r;  
    #access_log /var/log/nginx/host.access.log main;  
      
    location / {  
        root /usr/share/nginx/html; 
        index index.html index.htm;  
    }  
      
    #error_page 404 /404.html;  
            
    # redirect server error pages to the static page /50x.html  
    #  
    error_page 500 502 503 504 /50x.html;  
    location = /50x.html {  
        root /usr/share/nginx/html;  
    } 
      
    # proxy the PHP scripts to Apache listening on 127.0.0.1:80  
    #  
    #location ~ \.php$ {  
    # proxy_pass http://127.0.0.1; 
    #}  
      
    # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000  
    #  
    #location ~ \.php$ {  
    # root html;  
    # fastcgi_pass 127.0.0.1:9000;  
    # fastcgi_index index.php;  
    # fastcgi_param SCRIPT_FILENAME /scripts$fastcgi_script_name;  
    # include fastcgi_params;  
    #}  
      
    # deny access to .htaccess files, if Apache's document root  
    # concurs with nginx's one  
    #  
    #location ~ /\.ht {  
    # deny all;  
    #} 
}

5. Nginx 데몬 실행

[root@k5w1hcd ~]# systemctl start nginx  
[root@k5w1hcd ~]# systemctl enable nginx  
Created symlink from /etc/systemd/system/multi-user.target.wants/nginx.service to /usr/lib/systemd/system/nginx.service.

Composer : Dependency Manager for PHP

How To Install and Get Started With Composer on CentOS 7

위 페이지의 내용을 정리해둔 내용입니다.

CentOs7 에 Composer를 설치

소개

Composer는 프로젝트의 종속성을 추적하는 응용 프로그램이다. 프로젝트가 의존하는 모든 필수 PHP 패키지를 가져 와서 관리한다.

시스템 패키지 관리자 (예 :apt 또는 yum)를 대체하는 대신Composer를 사용하면 특정 프로젝트에 대한 라이브러리 세트를 지정할 수 있다. 라이브러리가 설정되면 Composer는 버전과 종속성을 식별하고 해당 프로젝트에 설치한다.

이 기사에서는 CentOS 7에 Composer를 설치하고 사용하는 방법을 알아 본다

전제 조건

• CentOS Linux 시스템
• PHP 5.3.2 이상 설치
• sudo 권한이있는 사용자 계정
• 명령 줄 \ 터미널 창에 액세스 (Ctrl+Alt+F2)

CentOS 7에 PHP Composer를 설치하는 단계

1 단계 : 로컬 리포지토리 업데이트

시스템에 무엇이든 다운로드하여 설치하기 전에 항상 로컬 저장소를 업데이트한다.

    sudo yum -y update

2 단계 : 소프트웨어 종속성 설치

지원 소프트웨어 설치부터 시작하십시오.터미널에 다음 명령을 입력한다.

    yum install php-cli php-zip wget unzip

필요한 종속성이 이미있는 경우 패키지의 최신 버전인지 확인한다.

3 단계 : Composer 설치 프로그램 스크립트 다운로드

다음으로 설치 스크립트를 다운로드해야합니다.다음 명령은 현재있는 디렉토리에 파일을 다운로드한다.

    php -r "copy('https:\\getcomposer.org\installer', 'composer-setup.php');"

4 단계 : 다운로드 무결성 확인

설치 스크립트가 있으면 무결성을 확인해야한다.

이렇게하려면 SHA-384 해시가 공식Composer 공개 키페이지에있는 설치자 서명 (SHA-384)과 일치하는지 확인해야한다.

Composer의 Github 페이지에서 HASH 변수의 승인 된 서명을 다운로드한다.

    HASH="$(wget -q -O - https:\\composer.github.io\installer.sig)"

그런 다음 다음 스크립트를 사용하여 공식 해시를 다운로드 한 해시와 비교한다.

    php -r "if (hash_file('SHA384', 'composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

두 서명이 일치하면 출력에설치 프로그램 확인메시지가 표시됩니다.

반면에 스크립트가 몇 가지 차이점을 감지하면 다음과 같이 표시됩니다.설치 프로그램 손상.이 문제를 해결하려면 Composer 설치 프로그램을 다시 다운로드해야한다.

5 단계 : Composer 설치

파일의 무결성을 확인한 후 Composer 설치로 이동할 수 있다.

전체 시스템에서 액세스 할 수있는 명령으로**\ usr \ local \ bin**디렉토리에Composer를 설치하려고 한다.

1. composer를 설치하려면 다음 명령을 사용한다..

    php composer-setup.php --install-dir=\usr\local\bin --filename=composer

설치가 초기화되면 다음 메시지가 나타난다.

    All settings correct for using Composer
    Downloading...
    
    Composer (version 1.6.5) successfully installed to: \usr\local\bin\composer
    Use it: php \usr\local\bin\composer

2. 설치 프로그램이 프로세스를 완료하면 올바르게 실행되고 있는지 확인한다.

    composer

* 시스템은 구문 및 사용 가능한 옵션과 함께 실행중인 버전을 표시해야한다.
       ______
      \ ____\___  ____ ___  ____  ____  ________  _____
     \ \   \ __ \\ __ `__ \\ __ \\ __ \\ ___\ _ \\ ___\
    \ \___\ \_\ \ \ \ \ \ \ \_\ \ \_\ (__  )  __\ \
    \____\\____\_\ \_\ \_\ .___\\____\____\\___\_\
                        \_\
    Composer version 1.9.0 2019-08-28 11:45:23
    
    Usage:
      command [options] [arguments]
    
    Options:
      -h, --help                     Display this help message
      -q, --quiet                    Do not output any message
      -V, --version                  Display this application version
          --ansi                     Force ANSI output
          --no-ansi                  Disable ANSI output
      -n, --no-interaction           Do not ask any interactive question
          --profile                  Display timing and memory usage information
          --no-plugins               Whether to disable plugins.

3. 마지막으로 설치 프로그램을 삭제한다.

    php –r “unlink(‘composer-setup.php’);”

기본 Composer 사용법

Composer는 프로젝트별로 종속성을 추적하여 다른 사용자가 동일한 환경을 쉽게 만들 수 있도록 도와줍니다.composer.json파일을 사용하여 필수 소프트웨어 및 허용 된 버전을 추적한다.

또한 누군가 명령을사용하여 자동으로 생성되는composer.lock파일을통해 디렉토리를 복사하 는 경우 일관성을 유지한다**require**.

이제새 PHP 프로젝트를 시작할 때 Composer를 활용하는 방법을살펴 본다**.**

1. 터미널을 열고 프로젝트 설명, 종속성 및 기타 추가 정보 (composer.json파일)가있는 파일에 대한 프로젝트 루트 디렉토리를 만든다.

    mkdir c_sample

2. 그런 다음 새 디렉터리로 이동한다.

    cd c_sample

3. 다음 단계는 패키지를 로드한다.웹 사이트**[packagist.org](https:\packagist.org)**에는 선택할 수있는 다양한 PHP 패키지가 있다.

이 예에서는프로젝트 용monolog \ monolog패키지를다운로드하여 사용한다. 슬래시 뒤의 정보는패키지 이름이고 슬래시 앞의 이름은공급 업체다.

소프트웨어를 다운로드와 함께, 시스템이 자동으로 생성됩니다composer.json의파일과composer.lock의명령으로 파일 :

    composer require monolog\monolog

4. 이제 디렉토리의 내용을 나열하여 모든 파일이 생성되었는지 확인한다.

    ls -l

콘텐츠 중composer.json 및composer.lock파일과 공급 업체디렉터리가 표시되어야한다.

5. 다음으로composer.json파일을 연다.

    cat composer.json

새로 추가 된 모노로그 소프트웨어의 버전 번호 옆에 소프트웨어의 최소 버전을 나타내는캐럿 (^) 기호가 표시된다.

자동 로딩을 설정하는 방법

클래스를자동로드하도록 Composer를 구성하여 종속성 작업을 단순화 할 수 있습니다(PHP는이를 자동으로 수행하지 않기 때문이다).

1. 원하는 텍스트 편집기를 사용하여 새 파일을 만든다 (이 예에서는 이름 아래에 있음**composer_sample**).

    vi composer_sample.php

2. 파일에 다음을 추가한다.

    <?php
    
    require __DIR__ . '\vendor\autoload.php';
    use Monolog\Logger;
    use Monolog\Handler\StreamHandler;
    
    \\ create a log channel
    $log = new Logger('name');
    $log->pushHandler(new StreamHandler('\~\c_sample\text.log', Logger::WARNING));
    
    \\ add records to the log
    $log->warning('Foo');
    $log->error('Bar');

3.저장하고종료합니다.

4. 이것으로 다음 명령을 사용하여monolog를자동로드할 수 있다.

    php composer_sample.php

종속성 업데이트

composer.json파일의모든 종속성을 업데이트해야 하는 경우 다음을 사용하여 수행 할 수 있다.

    composer update

이 명령은 파일에 지정된 버전에 따라 종속성을 업데이트한다.

하나 이상의 종속성을 개별적으로 업데이트 할 수도 있다.

    composer update vendor\package vendor_b\package_b

결론

이 가이드를 읽은 후에는 CentOS 7에서 Composer를 안전하게 설정하고 구성하는 방법을 알게되었다.또한 PHP 프로젝트 생성, 자동로드 설정, 종속성 업데이트를 포함한 Composer의 기본 사용법을 배웠다.

Python 모듈 import하는 방법

모듈? 라이브러리?

파이썬에서 모듈이라고 부르는 것은 C언어에서 라이브러리라고 부르는 것과 동일하다고 보면 될것 같다. 자주 사용하는 소스코드들을 미리 작성하여 프로그래머가 원할 때 빠르게 사용할 수 있게 가공된 형태를 말한다. 그외에도 유용한 코드를 관리하고 및 사용할 수 있게 묶어둔 파일이라고 보면 될것 같다.

현재 프로젝트에 있는 모듈 확인하기

>>>import pkg_resources; 
>>>installed_packages = [(d.project_name, d.version) for d in pkg_resources.working_set]

파이썬콘솔에서 확인하는 방법

• 파이참에서 확인하는 방법
  Ctrl+Alt+s(셋팅화면) 에서 Project: 현재 프로젝트명 > Python Interpreter 를 선택하면 현재 프로젝트의 모듈을 확인할 수 있다.

위의 파이썬 콘솔 결과창의 Installed_packages 를 보면 동일한 것을 알 수 있다.

파이썬의 전체 모듈리스트

모듈의 설치

모듈의 import를 하기전에 우선 설치를 먼저해야 하는데 이 방법은 Study 001에서 tqdm의 설치를 확인해보면 알 수 있다. 아래 Install Package를 선택하면 해당 모듈이 설치된다.

Ctrl+Alt+s(셋팅화면) 에서 Project: 현재 프로젝트명 > Python Interpreter 를 선택후 + 키를 눌러서 Available Packages 창을 열어 검색에 설치하고자 하는 모듈의 이름을 입력한후 해당 모듈을 선택하고 Install Package를 선택한다.

pip install [설치할 모듈이름]

그외에 콘솔(Terminal)에서 하는 경우 pip 명령을 이용할 수 있다.

모듈의 import

Automatically add import statements(자동으로 import문 추가하기

1. Ctrl_Alt+s를 눌러서 셋팅화면을 호출후 Editor > General > Auto Import 를 선택한다.
2. Python 을 선택하고, 설정한다.
   • Show import popup - import 문 이 없는 클래스의 이름을 묶을 때 자동으로 팝업을 표시하려면 선택한다.
   • Preferred import style - 옵션 중 하나를 선택하여 가져오기 문을 생성하는 방법을 정의한다.

import문 사용법

PS F:\MyProject\Pycharm_001> cd..
PS F:\MyProject> tree
STUDY 볼륨에 대한 폴더 경로의 목록입니다.
볼륨 일련 번호는 E89B-937C입니다.
.
├─상위폴더
├─Pycharm_001(현재폴더)
│  ├─.idea
│  │  ├─inspectionProfiles
│  │  └─ZeppelinRemoteNotebooks
│  ├─venv
│  │  ├─Lib
│  │  │  └─site-packages
│  │  │      ├─colorama
│  │  │      │  ├─tests
│  │  │      │  │  └─__pycache__
│  │  │      │  └─__pycache__
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
│  │  │      ├─tqdm
│  │  │      │  ├─contrib
│  │  │      │  │  └─__pycache__
│  │  │      │  └─__pycache__
│  │  │      ├─tqdm-4.65.0.dist-info
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
│  │  │      │  └─__pycache__
│  │  │      └─__pycache__
│  │  └─Scripts
│  │      └─venv
│  │          ├─Include
│  │          ├─Lib
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
│  ├─하위폴더

import tqdm
from colorama import *

파이썬에 기본으로 설치된 모듈과 패키지에서 import할때

from tdqm import tqdm
from colorama import just_fix_windows_console

모듈에서 필요한 함수만 import할때

import math as m
m.sqrt(4.0)

import as를 이용하여 모듈명을 변경할 수 있다.

$ from . import modulename

만약 원하는 모듈이 동일한 경로에 있을 경우엔, 위와 같이 .을 사용해서 import 할 수 있다.

$ from [하위폴더] import modulename

프로젝트의 메인 폴더보다 하위 경로에 있을 경우엔, 아래와 같이 하위폴더명을 지정하여 import 할 수 있다. (하위폴더 안에 있는 모듈을 사용할때 위와 같이 하면된다.)

$ import sys, os
sys.path.append(os.path.dirname(os.path.abspath(os.path.dirname(__file__))))
from [상위폴더에 속하는 폴더명] import modulename

프로젝트의 메인 폴더보다 상위 경로에 있을 경우엔, sys와 os를 import하여 상위 폴더의 위치를 설정하여 사용한다.(상위 폴더에 있는 모듈을 import할 수 있다.)

$ import sys, os
sys.path.append(os.path.dirname(os.path.abspath(os.path.dirname(__file__))))
from . import modulename

상위폴더에 모듈이 존재하는 경우

$ import sys, os
sys.path.append(os.path.dirname(os.path.abspath(os.path.dirname(os.path.abspath(os.path.dirname(__file__))))))
from . import want_to_import

두단계 상위폴더의 경우 위와 같이 지정한다.

import sys
sys.path.append([파일이 파일이 있는 경로])
from . import want_to_import

외부경로에 있는 모듈를 import하려면 sys.path.append에 해당 경로를 입력한다.

Pycharm의 코딩 지원 기능 2

Code reference information

매개변수 정보

매개 변수 정보 팝업에는 메서드 및 함수 호출의 매개변수 이름이 표시된다. PyCharm은 편집기에서 여는 괄호를 입력하거나 제안 목록에서 메서드를 선택한 후 1초(1000밀리초) 이내에 사용 가능한 모든 메서드 시그니처가 포함된 팝업을 자동으로 표시한다.

팝업이 닫히거나 IDE가 자동으로 팝업을 표시하지 않도록 구성된 경우 팝업을 명시적으로 호출할 수 있다 . 그렇게 하려면 Ctrl+P키를 누르면된다. (또는 보기 | 매개변수 정보 클릭 ).

전체 메서드 또는 함수 서명 표시
기본적으로 매개변수 정보 팝업에는 간단한 시그니쳐가 표시됩니다. 메서드 이름과 반환된 유형을 포함하는 전체 서명을 표시하도록 IDE를 구성할 수 있습니다.

셋팅화면 Ctrl+Alt+S 에서 Editor > General > Code Completion 에서 Parameter Info 항목의 Show full method signatures 체크박스를 체크한다.

프로젝트 소스 경로에 필요한 써드파티 JavaScript 라이브러리를 포함해야 한다. 그렇지 않으면 매개변수 이름이 표시되지 않는다.

Code inspections(코드 검사)

PyCharm에는 프로젝트의 비정상적인 코드를 감지하고 수정하는 일련의 코드 검사가 있다. IDE는 다양한 문제를 찾아 강조 표시하고, 죽은 코드를 찾고, 가능한 버그를 찾고, 맞춤법 문제를 찾고, 전체 코드 구조를 개선할 수 있다.

검사는 모든 프로젝트 파일 또는 특정 범위 (예: 프로덕션 코드 또는 수정된 파일) 에서만 코드를 스캔할 수 있다 .

모든 검사에는 문제가 코드에 영향을 미칠 수 있는 정도인 inspection severity(심각도 수준) 이 있다. 심각한 문제와 덜 중요한 문제를 빠르게 구분할 수 있도록 편집기에서 심각도가 다르게 강조 표시된다. PyCharm은 미리 정의된 심각도 수준 세트와 함께 제공되며 이를 통해 자신만의 심각도 수준을 만들 수 있다.

검사 및 해당 설정은 프로필 에 그룹화됩니다 . 각 프로필에는 활성화된 검사, 분석하는 파일 범위 및 해당 심각도 수준에 대한 정보가 포함되어 있습니다.

셋팅화면에서 Editor > Inspections 에서 Python 항목을 열어 필요한 항목의 체크박스를 체크한다.

• 검사 목록을 필터링하는 데 사용한다. 예를 들어 심각도 또는 언어별로 검사를 필터링할 수 있다.

검사 프로필의 구성에 영향을 줄 수 있으므로 설치된 플러그인에서 제공되는 새 검사를 비활성화
하려면 Disable new inspections by default를 선택한다 .

Pycharm Debug Console 의 한글깨짐 문제

파이참을 설치하고나서 바로 코딩후 실행을 하면 디버그콘솔의 한글이 깨져서 나온다. 이를 해결하는 방법은 Ctrl+Alt+s 를 눌러 셋팅창을 열어 Editor > File Encodings 화면에서 아래 그림에 표시된 부분의 내용을 UTF-8 로 변경한다.

Project Encoding : UTF-8
Default encoding for properties files : UTF-8

위의 내용대로 수정을 하면 다음과 같이 한글이 깨지지 않고 출력된다.

해당 방법이외에도 코드 삽입으로도 해결이 되기는 하지만 파이참에 대한 것만 기록하고자 하므로 위 방법만 적어둔다.

두번째 입니다. 작성중입니다.
천천히 사용법을 익히다보니 시간이 걸리네요. 혼자서 하는거라 앞으로도 빠르지는 않을 것 같습니다. 작성중인 문서를 포스팅하는 것은 지금 설치한 고스트의 프리뷰 기능이 제대로 되지를 않아서 그냥 포스팅을 하면서 문서를 수정하고 있습니다.

Pycharm의 코딩 지원 기능 1

Viewing Inline Documentation

계속해서 tqdm을 사용해보고 있습니다. 대단한 기능이 있다고 생각되지는 않지만 리눅스에서 패키지를 설치할때 텍스트상에서도 프로그레스바가 나오는 것이 인상적이어서 몇번은 더 써보고 싶은 라이브러리네요. 코딩을 하다보면 자주 사용하는 함수나 명령어라도 사용법을 확인할 필요가 있습니다. 이전에 델파이를 사용할때에도 자주 사용했던 기능이라 해당 기능이 있을까 했는데 파이참에도 이 기능이 있네요. 알고싶은 함수(function)에 마우스 커서를 가져다 놓고 ctrl키와 함께 좌클릭을 해줍니다. 그러면 아래 그림과 같이 해당 함수('function')의 정의 부분이 나옵니다.

그런데 해당 소스를 직접 수정할게 아니라면 조금 더 간편한 방법이 있네요. 물론 다른 툴에도 있는 기능들입니다.

알고싶은 함수(function)에 마우스 커서를 가져다 놓고 ctrl+q를 눌러줍니다. 그러면 아래와 같이 풍선도움말이 나옵니다.

그런데 이 경우도 조금 불편하다 싶으면 해당 도움말이 보이는 상태에서 ctrl+q를 한번 더 눌러줍니다. 그러면 아래와 같이 우측에 해당 내용이 출력됩니다.

파라메터와 파라메터에 대한 설명이 같이 보입니다.

tqdm의 파라메터와 그 설명입니다.

tqdm.std.tqdm def __init__(self,
             iterable: Any = None,
             desc: Any = None,
             total: Any = None,
             leave: Any = True,
             file: Any = None,
             ncols: Any = None,
             mininterval: Any = 0.1,
             maxinterval: Any = 10.0,
             miniters: Any = None,
             ascii: Any = None,
             disable: Any = False,
             unit: Any = 'it',
             unit_scale: Any = False,
             dynamic_ncols: Any = False,
             smoothing: Any = 0.3,
             bar_format: Any = None,
             initial: Any = 0,
             position: Any = None,
             postfix: Any = None,
             unit_divisor: Any = 1000,
             write_bytes: Any = False,
             lock_args: Any = None,
             nrows: Any = None,
             colour: Any = None,
             delay: Any = 0,
             gui: Any = False,
             **kwargs: Any) -> Any

iterable – 진행률 표시줄로 장식하는 반복 가능. 업데이트를 수동으로 관리하려면 공백으로 두십시오.
desc – 진행률 표시줄의 접두사입니다. 프로그레스바 앞에 텍스트를 출력합니다.
total – 예상되는 반복 횟수입니다. 지정하지 않으면 가능한len(iterable)이 사용됩니다. float("inf")인 경우 또는 최후의 수단으로 기본 진행률 통계만 표시됩니다(ETA 없음, 진행률 표시줄 없음). gui가 True이고 이 매개변수가 후속 업데이트가 필요한 경우 초기 임의의 큰 양수를 지정합니다.
leave – [기본값: True]인 경우 반복 종료 시 진행률 표시줄의 모든 추적을 유지합니다. None이면 위치가 0인 경우에만 떠납니다.
file – 진행률 메시지를 출력할 위치를 지정합니다(기본값: sys.stderr). file.write(str) 및 file.flush() 메서드를 사용합니다. 인코딩에 대해서는 write_bytes를 참조하십시오.
ncols – 전체 출력 메시지의 너비입니다. 지정된 경우 이 범위 내에 있도록 진행률 표시줄의 크기를 동적으로 조정합니다. 지정하지 않으면 환경 너비를 사용하려고 시도합니다. 폴백은 미터 너비 10이며 카운터 및 통계에 대한 제한이 없습니다. 0이면 미터를 인쇄하지 않습니다(통계만).
mininterval – 최소 진행률 표시 업데이트 간격[기본값: 0.1]초.
maxinterval – 최대 진행률 표시 업데이트 간격[기본값: 10]초. 긴 디스플레이 업데이트 지연 후 최소 간격에 해당하도록 미니터를 자동으로 조정합니다. dynamic_miniters 또는 모니터 스레드가 활성화된 경우에만 작동합니다.
miniters – 최소 진행률 표시 업데이트 간격(반복). 0 및 dynamic_miniters인 경우 동일한 mininterval로 자동 조정됩니다(CPU 효율이 더 높고 타이트한 루프에 적합). >0 인 경우 지정된 반복 횟수 표시를 건너뜁니다. 매우 효율적인 루프를 얻으려면 이것과 최소 간격을 조정하십시오. 빠른 반복과 느린 반복(네트워크, 항목 건너뛰기 등)으로 진행 상황이 불규칙한 경우 miniters=1로 설정해야 합니다.
ascii – 지정되지 않았거나 False인 경우 유니코드(부드러운 블록)를 사용하여 미터를 채웁니다. 폴백은 ASCII 문자 "123456789#"를 사용하는 것입니다.
disable – 전체 진행률 표시줄 래퍼를 비활성화할지 여부[기본값: False]. None으로 설정하면 TTY가 아닌 경우 비활성화합니다.
unit – 각 반복의 단위를 정의하는 데 사용할 문자열 [기본값: it].
unit_scale – 1 또는 True인 경우 반복 횟수가 자동으로 축소/확대되고 국제 단위계 표준을 따르는 메트릭 접두어가 추가됩니다(킬로, 메가 등)[기본값: False]. 0이 아닌 다른 숫자가 있으면 합계와 n을 조정합니다.
dynamic_ncols – 설정된 경우 ncols 및 nrows를 환경에 맞게 지속적으로 변경합니다(창 크기 조정 허용)[기본값: False].
smoothing – 속도 추정을 위한 지수 이동 평균 평활 계수(GUI 모드에서는 무시됨). 범위는 0(평균 속도)에서 1(현재/순간 속도)까지입니다[기본값: 0.3].
bar_format – 사용자 지정 막대 문자열 형식을 지정합니다. 성능에 영향을 줄 수 있습니다. [기본값: '{l_bar}{bar}{r_bar}'], where l_bar='{desc}: {percentage:3.0f}%|' 그리고 r_bar='| {n_fmt}/{total_fmt} [{elapsed}<{remaining},' '{rate_fmt}{postfix}]'
가능한 변수: l_bar, bar, r_bar, n, n_fmt, total, total_fmt, 백분율, 경과, elapsed_s, ncols, nrows, desc, 단위, 속도, rate_fmt, rate_noinv, rate_noinv_fmt, rate_inv, rate_inv_fmt, 접미사, unit_divisor, 남은, 잔여_s, 에타.{desc}가 비어 있으면 후행 ":"이 자동으로 제거됩니다.
initial – 초기 카운터 값입니다. 진행률 표시줄을 다시 시작할 때 유용합니다[기본값: 0]. float를 사용하는 경우 bar_format에서 {n:.3f} 또는 유사 항목을 지정하거나 unit_scale을 지정하는 것이 좋습니다.
position – 이 막대를 인쇄할 라인 오프셋을 지정합니다(0부터 시작) 지정하지 않으면 자동입니다. 한 번에 여러 막대를 관리하는 데 유용합니다(예: 스레드에서).
postfix – 막대 끝에 표시할 추가 통계를 지정합니다. 가능한 경우 set_postfix(**postfix)를 호출합니다(dict).
unit_divisor– [기본값: 1000], unit_scale이 True가 아니면 무시됩니다.
write_bytes – 바이트 쓰기 여부. If(기본값: False)는 유니코드를 작성합니다.
lock_args – 중간 출력(초기화, 반복 및 업데이트)을 위한 새로 고침에 전달됩니다.
nrows – 화면 높이. 지정된 경우 이 경계 외부에 중첩된 막대를 숨깁니다. 지정하지 않으면 환경 높이를 사용하려고 시도합니다. 대체는 20입니다.
color – 막대 색상(예: '녹색', '#00ff00').
delay – [기본값: 0]초가 경과할 때까지 표시하지 않습니다.
gui – 경고: 내부 매개변수 - 사용하지 마십시오. 대신 tqdm.gui.tqdm(...)을 사용하십시오. 설정하면 그래픽 출력에 matplotlib 애니메이션을 사용하려고 시도합니다[기본값: False].

프로그레스바를 수동으로 업데이트 하는 경우

update - 전체 진행도를 알고, 진행된만큼 진행바를 표시할 경우 update 에 진행도를 파라메터로 추가할 수 있다.
clear() - 화면 삭제
refresh()- 강제로 화면을 갱신합니다.

prog = tqdm(total=500, initial=200, ascii=True)
for i in range(200):
    time.sleep(0.1)
    prog.update( 400/200 )
prog.close()

파이썬 공부를 위해 파이참을 사용하면서 사용법을 기록해둡니다.
사실상 공부까지 할 필요는 없지만 툴을 잘 써보고 싶을 때가 있어서.
VsCode 도 충분히 좋지만 Pycharm이 써보고 싶어서~~

아래 내용의 앞부분은 Jetbrains.com 의 내용을 번역후 정리한 것입니다.

0. 설치

1. 새로운 프로젝트 생성

1-1. 환영 화면 에 있는 경우 새 프로젝트 를 클릭합니다 . 이미 열려 있는 프로젝트가 있으면 파일 | 메인 메뉴에서 새 프로젝트 .

1-2. PyCharm에서 다양한 유형의 프로젝트를 만들 수 있지만 이 자습서에서는 간단한 Pure Python 프로젝트 를 만들어 보겠습니다 . 이 템플릿은 빈 프로젝트를 생성합니다.

1-3. 프로젝트 위치를 선택합니다. Location찾아보기 버튼 필드 옆에 있는 버튼을 클릭 하고 프로젝트의 디렉토리를 지정합니다.

1-4. 또한 이 자습서를 위해 새 Python 파일을 만들 것이므로 main.py 시작 스크립트 만들기 확인란을 선택 취소합니다.

1-5. Python 의 기본 설정은 각 프로젝트에 대해 virtualenv를 만드는 것입니다. 대부분의 경우 PyCharm은 새로운 가상 환경을 자동으로 생성하므로 아무 것도 구성할 필요가 없습니다. 그래도 venv 옵션을 미리 보고 수정할 수 있습니다. Python Interpreter: New Virtualenv Environment 노드를 확장 하고 새 가상 환경을 만드는 데 사용되는 툴을 선택합니다.(Virtualenv가 기본적으로 선택되어 있습니다. 아마콘다를 사용하는 경우 Conda를 선택할 수도 있습니다.) 도구를 선택 하고 새 가상 환경에 사용되는 환경 및 기본 Python 인터프리터의 위치를 지정합니다.

프로젝트가 이미 열려 있는 경우 PyCharm 만들기를 클릭하면 현재 창에서 새 프로젝트를 열 것인지 새 창에서 열 것인지 묻는 메시지가 표시됩니다. 현재 창에서 열기를 선택합니다 . 그러면 현재 프로젝트가 닫히지만 나중에 다시 열 수 있습니다.

Base interpreter 는 파이썬 버젼이 여러가지 설치된 경우 해당 버젼을 선택할 수 있습니다.
2.x, 또는 3.x 를 버젼에서 프로젝트에 사용할 버젼을 선택할 수 있습니다. 처음공부하는 입장에서 굳이 버젼을 선택할 필요는 없을 듯 하고 현재는 3.10.4 를 설치해두어서 해당 버젼을 선택했습니다.

• 파이썬의 버젼은 하단의 Terminal 탭을 눌러서 터미널창을 열어 아래와 같이 입력하면 확인할 수 있습니다.

PS F:\MyProject\Pycharm_001> python --version
Python 3.10.4
PS F:\MyProject\Pycharm_001>

• 각창의 톱니바퀴 아이콘을 선택하면 창의 위치등을 변경할 수 있습니다. 추후에 본인이 디버깅을 하면서 편한 상태로 구성해서 사용하면 됩니다.

2. 프로젝트별 패키지 추가

초기에 공부하다 보면 tqdm 이라는 라이브러리를 사용하게 됩니다. tqdm에 대해서는 다음 기회에 공부하는 걸로 하고 쉽게 설명하면 텍스트상에서 프로그래스바를 출력해주는 라이브러리입니다. for 문을 배우면서 다들 사용예제를 tqdm으로 예제를 보여주더군요. 그런데 이게 설치가 되어 있는 라이브러리가 아니네요. PyCharm에서 어떻게 할까 고민하다가 tqdm 깃허브페이지에 설치방법이 나와 있습니다.

Stable버젼의 설치

pip install tqdm

깃허브상의 최신버젼 설치

pip install "git+https://github.com/tqdm/tqdm.git@devel#egg=tqdm"

그외에는 https://github.com/tqdm/tqdm#installation 를 참고하면 됩니다.

pip 명령은 python에서 이용하는 패키지 관리자입니다. 이를 이용할때에는 다음 그림에서 보이는 하단의 terminal을 눌러서 터미널창에 직접입력합니다.

설치했더니 'pip'가 업그레이드가 가능하다고 하길래 'pip'도 업그레이드를 했습니다. 설치를 했는데도 문제가 계속 생깁니다. module not found 라는 메세지가 나오네요. 이 부분에서 한참 막히더군요. 그러다가 Pycharm에서 관련된 부분을 찾았습니다.

File > Settings > Project:현재프로젝트명 > Python Interpreter 을 선택하면 아래 화면이 나옵니다. (단축키 Ctrl+Alt+S)

여기서 위에 표시된 + 표시를 누르면 다음 화면이 나오네요.

검색라인에 tqdm을 입력하면 tqmd 라이브러리가 확인됩니다. tqdm을 선택한후 아래에 있는 Install Package 를 누르고 닫으면 아래와 같이 프로젝트의 라이브러리에 tqdm이 설치됩니다.

이제 코드를 다시 실행해 봅니다.

제대로 실행이 되는 것을 확인할 수 있습니다.

tqdm 때문에 찾게 되었지만 Pycharm에서 프로젝트별 라이브러리의 관리가 어디서 되는지 찾았네요. 조금씩 사용하는 것에 흥미가 생기기 시작했습니다.

사실상 파이참의 사용법이라고 적기는 했지만 조금 하다보니 작은 프로그램이라도 하나 만들어보면서 해보면 재미있어질 것 같습니다. Vscode같은 에디터도 뭐 나름 괜찮지만 IDE 에 관심이 많은 저로서는 Pycharm을 사용해보려고 하는 중입니다.

코딩하면서 가장 헷갈렸던 것중 하나가 플러그인의 설치와 플러그인별 셋팅이더군요. 키보드와 관련해서도 IdeaVIM 같은 플러그인은 개인적인 취향에 따라 선택하는 것이 좋을 것 같습니다.

앞으로는 Python 으로 윈도우 어플리케이션을 만들어갈까 합니다. 아직은 뭐 준비단계입니다. Python으로 어플리케이션 작업을 해보기는 했지만 처음부터 차근차근 다시 시작합니다.

사용자추가 및 권한부여

# adduser <id>
$ sudo adduser new_user

# usermod <options> <group> <id>
$ sudo usermod -a -G sudo new_user

adduser 로 사용자를 추가하면 여러가지 개인정보, 비밀번호 생성 및 home 디렉토리 생성을 자동으로 진행해 줍니다.

cd /home 으로 이동하여 ls 명령어를 통해 new_user 디렉토리가 생성되었음을 확인할 수 있습니다.

sudo 권한 추가가 제대로 됐는지는 groups나 getent 명령어를 통해 확인할 수 있습니다.

# groups <id>
$ groups new_user

# 또는 getent group <group name>
$ getent group sudo

사용자 삭제는 userdel 명령어를 사용합니다.

# userdel <options> <id>
$ sudo userdel -r new_user

방화벽 설치

sudo apt update && sudo apt install firewalld -y
sudo firewall-cmd --version

룰 추가

sudo firewall-cmd --permanent --zone=public --add-port=8080/tcp

룰 적용

sudo firewall-cmd --reload

방화벽 설정값 조회

sudo firewall-cmd --list-all

ufw 방화벽 (우분투 18.04 LTS 이후 지원)

활성화

sudo ufw enable

비활성화

sudo ufw disable

상태조회

sudo ufw status verbose

기본 룰 조회

sudo ufw show raw

or

sudo cat /etc/ufw/user.rules

ufw default rules 허용 또는 차단

ufw default rules 허용

sudo ufw default allow

ufw default rules 차단

sudo ufw default deny

ufw rule 허용 또는 차단

TCP 8080 포트(port) 허용

sudo ufw allow 8080/tcp

TCP 8080 port 차단

sudo ufw deny 8080/tcp

UDP 22 port 허용

sudo ufw allow 22/udp

UDP 22 port 차단

sudo ufw deny 22/udp

TCP/UDP 53 port 허용

sudo ufw allow 53

TCP/UDP 53 port 차단

sudo ufw deny 53

네트워크 카드 이름 확인

ls /sys/class/net

mkpassword 사용을 위한 whois 설치

mkpasswd 사용을 위해서 whois를 설치

$ sudo apt-get install whois

해시된 암호 생성. 사용가능한 해시함수(DES, MD5, SHA-256 or SHA-512.)

$ printf "password" | mkpasswd --stdin --method=des
ASYRtiLFCipT6

$ printf "secondarypassword" | mkpasswd --stdin --method=md5
$1$R29iAdV/$1QUKx8eo6e5pcMIEgaZwt0

$ printf "thirdpassword" | mkpasswd --stdin --method=sha-256
$5$gZZsvtRWI$9JIU8pfHLG8BtYW5tceAKD1oNAjjfL5e4LwUfAW1sqA

테스트 서버 구축을 위한 것이기 때문에 기본 레포지토리에 있는것을 이용하여 설치한다.

1. 아파치 서버 설치

설치전

init.d 에 있는 daemon들의 목록을 확인해본다.

root@k5w1hcd-155105:/etc/init.d# ll
total 140
drwxr-xr-x  2 root root 4096 Dec 31 06:27 ./
drwxr-xr-x 92 root root 4096 Dec 31 06:34 ../
-rwxr-xr-x  1 root root 3740 Apr  1  2020 apparmor*
-rwxr-xr-x  1 root root 2964 Dec  7  2019 apport*
-rwxr-xr-x  1 root root 1071 Jul 24  2018 atd*
-rwxr-xr-x  1 root root 1232 Mar 27  2020 console-setup.sh*
-rwxr-xr-x  1 root root 3059 Feb 11  2020 cron*
-rwxr-xr-x  1 root root  937 Feb  4  2020 cryptdisks*
-rwxr-xr-x  1 root root  896 Feb  4  2020 cryptdisks-early*
-rwxr-xr-x  1 root root 3152 Sep 30  2019 dbus*
-rwxr-xr-x  1 root root  985 Apr 15  2020 grub-common*
-rwxr-xr-x  1 root root 3809 Jul 29  2019 hwclock.sh*
-rwxr-xr-x  1 root root 2638 Dec 14  2019 irqbalance*
-rwxr-xr-x  1 root root 1503 Apr  2  2019 iscsid*
-rwxr-xr-x  1 root root 1479 Nov 27  2019 keyboard-setup.sh*
-rwxr-xr-x  1 root root 2044 Feb 19  2020 kmod*
-rwxr-xr-x  1 root root  695 Jan 28  2020 lvm2*
-rwxr-xr-x  1 root root  586 Jan 28  2020 lvm2-lvmpolld*
-rwxr-xr-x  1 root root 2827 Jan 10  2020 multipath-tools*
-rwxr-xr-x  1 root root 1364 Sep 14  2019 netfilter-persistent*
-rwxr-xr-x  1 root root 2503 Apr  2  2019 open-iscsi*
-rwxr-xr-x  1 root root 1846 Mar 10  2020 open-vm-tools*
-rwxr-xr-x  1 root root 1366 Mar 23  2020 plymouth*
-rwxr-xr-x  1 root root  752 Mar 23  2020 plymouth-log*
-rwxr-xr-x  1 root root  924 Feb 14  2020 procps*
-rwxr-xr-x  1 root root 4417 Oct 15  2019 rsync*
-rwxr-xr-x  1 root root 2864 Mar  7  2019 rsyslog*
-rwxr-xr-x  1 root root 1222 Apr  3  2017 screen-cleanup*
-rwxr-xr-x  1 root root 3939 Feb 26  2020 ssh*
-rwxr-xr-x  1 root root 6872 Apr 22  2020 udev*
-rwxr-xr-x  1 root root 2083 Jan 22  2020 ufw*
-rwxr-xr-x  1 root root 1391 Apr 14  2020 unattended-upgrades*
-rwxr-xr-x  1 root root 1306 Apr  3  2020 uuidd*
root@k5w1hcd-155105:/etc/init.d#

systemctl status 명령으로 현재 동작여부도 확인해본다.

root@k5w1hcd-155105:/etc/init.d# systemctl status
● k5w1hcd-155105
    State: running
     Jobs: 0 queued
   Failed: 0 units
    Since: Wed 2021-12-29 23:31:28 KST; 2 weeks 0 days ago
   CGroup: /
           ├─user.slice
           │ └─user-0.slice
           │   ├─session-408.scope
           │   │ ├─286317 sshd: root@notty
           │   │ └─286511 /usr/lib/openssh/sftp-server
           │   ├─session-406.scope
           │   │ ├─286315 sshd: root@pts/0
           │   │ ├─286516 -bash
           │   │ ├─286519 bash -c while [ -d /proc/$PPID ]; do sleep 1;head -v -n 8 /proc/meminfo; head -v -n 2 /proc/stat /proc/version /proc/uptime /proc/loadavg /proc/sys/fs/file->
           │   │ ├─290640 sleep 1
           │   │ ├─290641 systemctl status
           │   │ └─290642 pager
           │   └─user@0.service …
           │     └─init.scope
           │       ├─286334 /lib/systemd/systemd --user
           │       └─286335 (sd-pam)
           ├─init.scope
           │ ├─  1 /lib/systemd/systemd --system --deserialize 32
           │ └─543 bpfilter_umh
           └─system.slice
             ├─irqbalance.service
             │ └─705 /usr/sbin/irqbalance --foreground
             ├─packagekit.service
             │ └─288728 /usr/lib/packagekit/packagekitd
             ├─systemd-networkd.service
             │ └─120896 /lib/systemd/systemd-networkd
             ├─systemd-udevd.service
             │ └─114375 /lib/systemd/systemd-udevd
             ├─cron.service
             │ └─693 /usr/sbin/cron -f
             ├─system-serial\x2dgetty.slice
             │ └─serial-getty@ttyS0.service
             │   └─775 /sbin/agetty -o -p -- \u --keep-baud 115200,38400,9600 ttyS0 vt220
             ├─polkit.service
             │ └─155881 /usr/lib/policykit-1/polkitd --no-debug
             ├─networkd-dispatcher.service
             │ └─706 /usr/bin/python3 /usr/bin/networkd-dispatcher --run-startup-triggers
             ├─multipathd.service
             │ └─501 /sbin/multipathd -d -s
             ├─accounts-daemon.service
             │ └─129171 /usr/lib/accountsservice/accounts-daemon
             ├─systemd-journald.service
             │ └─120922 /lib/systemd/systemd-journald
             ├─atd.service
             │ └─732 /usr/sbin/atd -f
             ├─unattended-upgrades.service
             │ └─839 /usr/bin/python3 /usr/share/unattended-upgrades/unattended-upgrade-shutdown --wait-for-signal
             ├─ssh.service
             │ └─130082 sshd: /usr/sbin/sshd -D [listener] 0 of 10-100 startups
             ├─fwupd.service
             │ └─287035 /usr/libexec/fwupd/fwupd
             ├─snapd.service
             │ └─112215 /usr/lib/snapd/snapd
             ├─rsyslog.service
             │ └─709 /usr/sbin/rsyslogd -n -iNONE
             ├─systemd-resolved.service
             │ └─120916 /lib/systemd/systemd-resolved
             ├─dbus.service
             │ └─695 /usr/bin/dbus-daemon --system --address=systemd: --nofork --nopidfile --systemd-activation --syslog-only
             ├─systemd-timesyncd.service
             │ └─121015 /lib/systemd/systemd-timesyncd
             ├─system-getty.slice
             │ └─getty@tty1.service
             │   └─783 /sbin/agetty -o -p -- \u --noclear tty1 linux
             └─systemd-logind.service
               └─727 /lib/systemd/systemd-logind

root@k5w1hcd-155105:/etc/init.d#

apt-get 을 이용하여 설치한다.

$ sudo apt-get update
$ sudo apt-get install apache2

설치후 확인을 해보면 apache2 가 있는 것을 확인할 수 있다.

root@k5w1hcd-155105:/etc/init.d# ll /etc/init.d/
total 152
drwxr-xr-x  2 root root 4096 Jan 13 13:40 ./
drwxr-xr-x 93 root root 4096 Jan 13 13:40 ../
-rwxr-xr-x  1 root root 2489 Oct  1  2020 apache-htcacheclean*
-rwxr-xr-x  1 root root 8181 Oct  1  2020 apache2*
-rwxr-xr-x  1 root root 3740 Apr  1  2020 apparmor*
-rwxr-xr-x  1 root root 2964 Dec  7  2019 apport*
-rwxr-xr-x  1 root root 1071 Jul 24  2018 atd*
-rwxr-xr-x  1 root root 1232 Mar 27  2020 console-setup.sh*
-rwxr-xr-x  1 root root 3059 Feb 11  2020 cron*
-rwxr-xr-x  1 root root  937 Feb  4  2020 cryptdisks*
-rwxr-xr-x  1 root root  896 Feb  4  2020 cryptdisks-early*
-rwxr-xr-x  1 root root 3152 Sep 30  2019 dbus*
-rwxr-xr-x  1 root root  985 Apr 15  2020 grub-common*
-rwxr-xr-x  1 root root 3809 Jul 29  2019 hwclock.sh*
-rwxr-xr-x  1 root root 2638 Dec 14  2019 irqbalance*
-rwxr-xr-x  1 root root 1503 Apr  2  2019 iscsid*
-rwxr-xr-x  1 root root 1479 Nov 27  2019 keyboard-setup.sh*
-rwxr-xr-x  1 root root 2044 Feb 19  2020 kmod*
-rwxr-xr-x  1 root root  695 Jan 28  2020 lvm2*
-rwxr-xr-x  1 root root  586 Jan 28  2020 lvm2-lvmpolld*
-rwxr-xr-x  1 root root 2827 Jan 10  2020 multipath-tools*
-rwxr-xr-x  1 root root 1364 Sep 14  2019 netfilter-persistent*
-rwxr-xr-x  1 root root 2503 Apr  2  2019 open-iscsi*
-rwxr-xr-x  1 root root 1846 Mar 10  2020 open-vm-tools*
-rwxr-xr-x  1 root root 1366 Mar 23  2020 plymouth*
-rwxr-xr-x  1 root root  752 Mar 23  2020 plymouth-log*
-rwxr-xr-x  1 root root  924 Feb 14  2020 procps*
-rwxr-xr-x  1 root root 4417 Oct 15  2019 rsync*
-rwxr-xr-x  1 root root 2864 Mar  7  2019 rsyslog*
-rwxr-xr-x  1 root root 1222 Apr  3  2017 screen-cleanup*
-rwxr-xr-x  1 root root 3939 Feb 26  2020 ssh*
-rwxr-xr-x  1 root root 6872 Apr 22  2020 udev*
-rwxr-xr-x  1 root root 2083 Jan 22  2020 ufw*
-rwxr-xr-x  1 root root 1391 Apr 14  2020 unattended-upgrades*
-rwxr-xr-x  1 root root 1306 Apr  3  2020 uuidd*
root@k5w1hcd-155105:/etc/init.d#

2. 아파치 서버 실행

$ sudo service apache2 start

또는

sudo systemctl start apache2

실행 여부를 확인해보면

root@k5w1hcd-155105:~# ps aux | grep apache2
root      292093  0.0  0.2   6672  4780 ?        Ss   13:40   0:00 /usr/sbin/apache2 -k start
www-data  292096  0.0  0.2 1211560 4452 ?        Sl   13:40   0:00 /usr/sbin/apache2 -k start
www-data  292097  0.0  0.2 1211560 4452 ?        Sl   13:40   0:00 /usr/sbin/apache2 -k start
root      294053  0.0  0.0   8160   736 pts/0    S+   13:44   0:00 grep --color=auto apache2
root@k5w1hcd-155105:~# 

또는

root@k5w1hcd-155105:~# systemctl status apache2
● apache2.service - The Apache HTTP Server
     Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
     Active: active (running) since Thu 2022-01-13 13:40:36 KST; 6min ago
       Docs: https://httpd.apache.org/docs/2.4/
   Main PID: 292093 (apache2)
      Tasks: 55 (limit: 2344)
     Memory: 5.8M
     CGroup: /system.slice/apache2.service
             ├─292093 /usr/sbin/apache2 -k start
             ├─292096 /usr/sbin/apache2 -k start
             └─292097 /usr/sbin/apache2 -k start

Jan 13 13:40:36 k5w1hcd-155105 systemd[1]: Starting The Apache HTTP Server...
Jan 13 13:40:36 k5w1hcd-155105 apachectl[292086]: AH00558: apache2: Could not reliably determine the server's fully qualified domain name, using 10.6.2.160. Set the 'ServerName' dire>
Jan 13 13:40:36 k5w1hcd-155105 systemd[1]: Started The Apache HTTP Server.

root@k5w1hcd-155105:~#

3. 아파치 설정

3-1. 설정 디렉토리 및 파일

/etc/apache2
config 파일 위치로, config 파일들이 이 디렉토리 밑에 위치하고 있다.

/etc/apache2/apache2.conf
기본 config 파일로, 다른 리눅스 배포판에서는 httpd.conf를 config 파일로 사용하고 있지만 우분투에서는 apache2.conf를 사용한다.

/etc/apache2/conf.d
고급 config 파일로, 다른 리눅스 배포판에서 httpd.conf 파일 하나에 설정되어 있던 문자셋과 에러메시지, 보안과 관련된 설정을 따로 따로 분리하여 conf.d 디렉토리밑에서 설정하고 있다. 또한 사용자가 설치하게 되는 Apache와 관련된 애플리케이션들의 설정파일들도 위치하게 된다.

/etc/apache2/envvars
apache2ctl 환경설정 파일이다.

/etc/apache2/httpd.conf
사용자의 특정 설정 파일로, 역사적으로 httpd.conf 가 config 파일이였는데 지금은 빈파일이다. 사용자가 특정 설정을 부여해서 사용할 수 잇다.

/etc/apache2/magic
파일의 시작값(magic number) 데이터베이스. 이 값에 기반해 전송하는 파일의 MIME Type을 결정한다. 가급적 수정하지 말 것.

/etc/apache2/mods-available
사용가능한 Apache 모듈을 불러오는 곳이다.

/etc/apache2/mods-enabled
위의 /etc/apache2/mods-available 의 모듈중에 사용할 모듈을 심볼릭 링크로 추가하여 실제 동작하게 만든다.

/etc/apache2/ports.conf
Apache 서버의 서비스 포트 설정으로 http의 기본값 80 과 https의 기본값 443, 가상호스트의 포트들을 설정할 수 있다.

/etc/apache2/sites-available
서버에서 운영할 사이트의 설정파일이다.

/etc/apache2/sites-enabled
위의 /etc/apache2/sites-available에서 설정한 파일을 심볼릭 링크로 추가하여 실제 운영에 사용할 설정파일들이다.

WM_COPYDATA AND TCOPYDATASTRUCT

위링크의 내용을 간략하게 번역해두었습니다.

WM_COPYDATA 메시지를 사용하면 한 응용 프로그램에서 다른 응용 프로그램으로 데이터를 보낼 수 있습니다. 수신 응용 프로그램은 TCopyDataStruct 레코드로 데이터를 수신합니다. TCopyDataStruct는 Windows.pas 유닛에 정의되어 있으며 전달할 데이터가 들어있는 COPYDATASTRUCT 구조체를 래핑합니다.

다음은 TCopyDataStruct 레코드의 선언과 설명입니다.

 type
 TCopyDataStruct = packed record
 dwData: DWORD; //up to 32 bits of data to be passed to the receiving application
 cbData: DWORD; //the size, in bytes, of the data pointed to by the lpData member
 lpData: Pointer; //Points to data to be passed to the receiving application. This member can be nil.
 end; 

WM_COPYDATA 이용하여 문자열 전송하기

Sender프로세스에서 Receiver에게 데이터를 보내려면 CopyDataStruct 에 변수를 저장하여 SendMessage 함수를 사용하여 전달해야합니다. WM_CopyData에 문자열 값을 보내는 방법은 다음과 같습니다.

 procedure TSenderMainForm.SendString() ;
 var
 stringToSend : string;
 copyDataStruct : TCopyDataStruct;
 begin
 stringToSend := 'About Delphi Programming';

 copyDataStruct.dwData := 0; //use it to identify the message contents
 copyDataStruct.cbData := 1 + Length(stringToSend) ;
 copyDataStruct.lpData := PChar(stringToSend) ;

 SendData(copyDataStruct) ;
 end;

SendData 사용자 지정 함수는 FindWindow API 호출을 사용하여 Receiver 프로세스를 찾습니다.

 procedure TSenderMainForm.SendData(const copyDataStruct: TCopyDataStruct) ;
 var
   receiverHandle : THandle;
   res : integer;
 begin
   receiverHandle := FindWindow(PChar('TReceiverMainForm'),PChar('ReceiverMainForm')) ;
   if receiverHandle = 0 then
   begin
     ShowMessage('CopyData Receiver NOT found!') ;
     Exit;
   end;

   res := SendMessage(receiverHandle, WM_COPYDATA, Integer(Handle), Integer(@copyDataStruct)) ;
 end;

위의 코드에서 기본 폼 ( "TReceiverMainForm")의 클래스 이름과 Windows 캡션 ( "ReceiverMainForm")을 전달하여 FindWindow API 호출을 사용하여 Receiver 어플리케이션을 찾았습니다.

참고 : SendMessage는 WM_CopyData 메시지를 처리하는 코드에서 할당 한 정수 값을 반환합니다.

HANDLING WM_COPYDATA - RECEIVING A STRING

Receiver 어플리케이션은 다음과 같이 WM_CopyData 메시지를 처리합니다.

 type
 TReceiverMainForm = class(TForm)
 private
 procedure WMCopyData(var Msg : TWMCopyData) ; message WM_COPYDATA;
 ...
 implementation
 ...
 procedure TReceiverMainForm.WMCopyData(var Msg: TWMCopyData) ;
 var
 s : string;
 begin
 s := PChar(Msg.CopyDataStruct.lpData) ;

 //Send something back
 msg.Result := 2006;
 end;

TWMCopyData 레코드는 다음과 같이 선언됩니다.

 TWMCopyData = packed record
 Msg: Cardinal;
 From: HWND;//Handle of the Window that passed the data
 CopyDataStruct: PCopyDataStruct; //data passed
 Result: Longint;//Use it to send a value back to the "Sender"
 end;

문자열 전송, 일반화된 레코드 or 이미지?
아래 소스 코드는 문자열, 레코드(복합 데이터 형식) 및 그래픽 (비트맵)을 다른 어플리케이션으로 보내는 방법을 보여줍니다.

다운로드를 기다릴 수없는 경우 TBitmap 그래픽을 보내는 방법은 다음과 같습니다.

 procedure TSenderMainForm.SendImage() ;
 var
 ms : TMemoryStream;
 bmp : TBitmap;
 copyDataStruct : TCopyDataStruct;
 begin
 ms := TMemoryStream.Create;
 try
 bmp := self.GetFormImage;
 try
 bmp.SaveToStream(ms) ;
 finally
 bmp.Free;
 end;

 copyDataStruct.dwData := Integer(cdtImage) ; // identify the data
 copyDataStruct.cbData := ms.Size;
 copyDataStruct.lpData := ms.Memory;

 SendData(copyDataStruct) ;
 finally
 ms.Free;
 end;
 end;

받는 방법 :

 procedure TReceiverMainForm.HandleCopyDataImage(
 copyDataStruct: PCopyDataStruct) ;
 var
 ms: TMemoryStream;
 begin
 ms := TMemoryStream.Create;
 try
 ms.Write(copyDataStruct.lpData^, copyDataStruct.cbData) ;
 ms.Position := 0;
 receivedImage.Picture.Bitmap.LoadFromStream(ms) ;
 finally
 ms.Free;
 end;
 end;

Message in the Bottle
Monitoring Registry Changes
API hooking revealed
How to monitor directory / file changes on network share
Change Notifier Component Example
How can I increase a performance of standard TTreeView/TListView?

가디언 오브 갤럭시 3

가디언스 오브 갤럭시 1을 본 것이 엊그제 같은데 벌써 세번째가 나오다니...
아이언맨과 앤트맨3번째를 제외하고는 모두 메가박스의 MX관에서 봐왔다.

그런데 유일하게 IMAX로 본것이 가디언스 오브 갤럭시 1 이었다.
피터 퀼의 첫 장면 보석을 훔치러가면서 기분좋게 노래하는 그 장면의 느낌이 좋아서 2D로 한번 더 본 시리즈였다.

마블 시네마틱 유니버스에서 스타로드는 가장 매력적인 히어로이면서 가장 능력이 떨어지는 히어로가 아닐까 싶다.

그러나 그 동료들과 함께 하면서 하나의 히어로 역할을 하게 되는 집단이고 마블 시네마틱 유니버스에서 가장 중요한 역할을 하는 집단이라는 느낌이 든다.

음악과 영상의 즐거움이 가장 큰 영화였기에 보러갈 예정이다. 마블 시네마틱 유니버스에 대해서도 많이 읽어보면 재미있을 듯 하다.

자주 가는 송도국제도시 메가박스

Marvel Cinematic Universe

영화관은 쾌적한 메가박스MX관이 좋다. 의자도 넓어서 좋구, 사운드는 영상의 입체감까지 살려주기 때문에 3D를 보는 것보다 더욱 좋은 느낌을 준다...(개인적으로)

이번에 가오갤3를 보러가면서 사진도 좀 찍어둬야겠다..