yasd - GitLite

KO | EN

gitlite — search

#ai #typescript #android #deep-learning #linux #docker #macos #windows #awesome #kubernetes #awesome-list #pytorch #security #openai

yasd

(★ 360)

Yet Another Swoole Debugger

파일 탐색기

최종 버전 다운로드 (.zip)

- - alpine.Dockerfile
  - ext.yml
- ISSUE_TEMPLATE
- base.h
- base64.h
- buffer.h
- cmder_debugger.h
- common.h
- context.h
- dbgp.h
- debuger_mode_base.h
- global.h
- logger.h
- redirect_file_to_cin.h
- remote_debugger.h
- source_reader.h
- util.h
- watch_point.h
- zend_property_info.h
- analyze_function.php
- trace_function.php
- base.cc
- base64.cc
- buffer.cc
- cmder_debugger.cc
- common.cc
- context.cc
- dbgp.cc
- debuger_mode_base.cc
- global.cc
- logger.cc
- remote_debugger.cc
- source_reader.cc
- util.cc
- - swoole.ini
  - yasd.ini
- - bootstrap.php
- - DbgpClient.php
- clean
- inc_template
- new.php
- README.md
- run-tests
- start.sh
- template
- - tinyxml2.cc
  - tinyxml2.h
.clang-format
.gitignore
.php_cs
composer.json
composer.lock
config.m4
header.php
init_file.php
LICENSE
php_yasd.h
php_yasd_cxx.cc
php_yasd_cxx.h
README-CN.md
README.md
test.php
yasd.cc
yasd_api.cc
yasd_api.h
yasd_api.stub.php
yasd_function_status.cc
yasd_function_status.h

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/swoole/yasd

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd yasd

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Homebrew macOS/Linux용 패키지 매니저입니다.
APT (Debian/Ubuntu 계열) Debian/Ubuntu 계열 리눅스에 기본 내장된 패키지 매니저입니다.

brew install boost

Homebrew로 이미 빌드된 패키지를 바로 설치합니다. 소스 빌드가 필요 없습니다.

apt-get install libboost-all-dev

APT 패키지 저장소에서 바로 설치합니다 (Debian/Ubuntu 계열).

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. PHP (Composer)

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
PHP PHP 실행 환경이 필요합니다.
Composer PHP 라이브러리 설치를 위한 패키지 매니저입니다.

composer dump-autoload -o

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ php -S localhost:8000 같은 내장 서버로 실행한 뒤 브라우저에서 http://localhost:8000 으로 접속해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

English | [中文](./README-CN.md)

# yasd

> Swoole 5.0.1 + PHP 8.1 already support xdebug, so there is no need to use the yasd debugger!

Yet Another Swoole Debugger. [document](https://huanghantao.github.io/yasd-wiki/)

## How to use it

**Notice: if you use Swoole\Server, set the `worker_num` to 1, otherwise the breakpoint may fail.**

### build

You'll need to install the Boost library first.

macOS:

```bash
brew install boost
```

Ubuntu:

```bash
apt-get install libboost-all-dev
```

CentOS:

```bash
yum install boost boost-devel
```

```bash
phpize --clean && \
phpize && \
./configure && \
make clean && \
make && \
make install
```

set the ini file:

```ini
zend_extension=yasd
```

see the extension info:

```bash
php --ri yasd
```

### IDE debug mode

```ini
zend_extension=yasd
yasd.debug_mode=remote
yasd.remote_host=127.0.0.1
yasd.remote_port=9000
```

### cmd debug mode

All command supports fuzzy matching of priorities.

set the ini file:

```ini
zend_extension=yasd
yasd.debug_mode=cmd
```

#### start debug

```bash
php -e test.php
```

#### list

```bash
l
```

list source code

#### breakpoint

```bash
b absolute-file-path lineno
```

This will also save the breakpoint information in the cache file -- `.breakpoints_file.log`

You can change this file name by the ini file, e.g.

```ini
yasd.breakpoints_file="yasd.log"
```

If the cache file exists, the breakpoints in the file are automatically loaded when debug is started.

#### Delete breakpoints

```bash
d number
```

If a breakpoint is set or deleted without specifying `absolute-file-path`, It will set breakpoint in the current file.

#### watch point

We can monitor the variable changes or expression, for example:

```cpp
watch $a
```

```cpp
watch $a > 10
```

```cpp
watch $name == 'swoole'
```

#### unwatch point

```cpp
unwatch number
```

#### run

```bash
r
```

#### step over

```bash
n
```

#### step into

```bash
s
```

#### step out

```bash
f
```

#### backtrace

```bash
bt
```

#### info

show all breakpoints:

```bash
info breakpoints
```

show all watchpoints:

```bash
info watchpoints
```

#### continue

```bash
c
```

#### quit

```bash
q
```

#### print

```bash
p $a
p $this
p $this->prop
```

#### level

```bash
le
```

### Q&A

#### Debugging with phpstorm (remote mode)

- the port phpstorm listens on should be the one used for xdebug, also make sure remote connections are allowed:
![image](https://user-images.githubusercontent.com/21345604/109924706-c2044180-7cd1-11eb-80a1-79af023ea01e.png)
- do **NOT** forget to use `-e` option when running scripts, debugging will not work otherwise

- ensure that phpstorm listens on incoming connections:

![image](https://user-images.githubusercontent.com/21345604/109924880-042d8300-7cd2-11eb-9972-002806afbb6c.png)

#### Slow Start Framework

When using `yasd`, if the framework starts slowly (most of the time it's because the framework is scanning a lot of files), you can execute the following command.

##### Hyperf

```bash
composer dump-autoload -o
```

Then modify the following configuration `config/config.php`:

```php
'scan_cacheable' => env('SCAN_CACHEABLE', true)
```

##### Imi

We did not find a slow start problem.

##### EasySwoole

We did not find a slow start problem.

##### MixPHP

We did not find a slow start problem.

##### Swoft

We did not find a slow start problem.

##### One

We did not find a slow start problem.

#### The breakpoint is not triggered

1. No absolute path to the file is used
2. The breakpoint is not a valid line, such as a function declaration, blank line, etc
3. The code is generated with proxy classes, such as Hyperf. So you need to set breakpoints in the proxy class.