์ด๊ฒ์ ์ต์ ๋ฆด๋ฆฌ์ค๋ฅผ 4.7.15sourcecode.zip์ผ๋ก ๋ค์ด๋ก๋ํ ์ ์๋ swagger-php๋ผ๋ Windows ์ฑ์ ๋๋ค. ์ํฌ์คํ ์ด์ ์ฉ ๋ฌด๋ฃ ํธ์คํ ์ ๊ณต์ ์ฒด์ธ OnWorks์์ ์จ๋ผ์ธ์ผ๋ก ์คํํ ์ ์์ต๋๋ค.
OnWorks์ ํจ๊ป swagger-php๋ผ๋ ์ด ์ฑ์ ๋ฌด๋ฃ๋ก ๋ค์ด๋ก๋ํ์ฌ ์จ๋ผ์ธ์ผ๋ก ์คํํ์ญ์์ค.
์ด ์ฑ์ ์คํํ๋ ค๋ฉด ๋ค์ ์ง์นจ์ ๋ฐ๋ฅด์ธ์.
- 1. ์ด ์ ํ๋ฆฌ์ผ์ด์ ์ PC์ ๋ค์ด๋ก๋ํ์ต๋๋ค.
- 2. ํ์ผ ๊ด๋ฆฌ์ https://www.onworks.net/myfiles.php?username=XXXXX์ ์ํ๋ ์ฌ์ฉ์ ์ด๋ฆ์ ์ ๋ ฅํฉ๋๋ค.
- 3. ์ด๋ฌํ ํ์ผ ๊ด๋ฆฌ์์์ ์ด ์์ฉ ํ๋ก๊ทธ๋จ์ ์ ๋ก๋ํฉ๋๋ค.
- 4. ์ด ์น์ฌ์ดํธ์์ ๋ชจ๋ OS OnWorks ์จ๋ผ์ธ ์๋ฎฌ๋ ์ดํฐ๋ฅผ ์์ํ์ง๋ง ๋ ๋์ Windows ์จ๋ผ์ธ ์๋ฎฌ๋ ์ดํฐ๋ฅผ ์์ํฉ๋๋ค.
- 5. ๋ฐฉ๊ธ ์์ํ OnWorks Windows OS์์ ์ํ๋ ์ฌ์ฉ์ ์ด๋ฆ์ผ๋ก ํ์ผ ๊ด๋ฆฌ์ https://www.onworks.net/myfiles.php?username=XXXXX๋ก ์ด๋ํฉ๋๋ค.
- 6. ์ ํ๋ฆฌ์ผ์ด์ ์ ๋ค์ด๋ก๋ํ์ฌ ์ค์นํฉ๋๋ค.
- 7. Linux ๋ฐฐํฌ ์ํํธ์จ์ด ์ ์ฅ์์์ Wine์ ๋ค์ด๋ก๋ํฉ๋๋ค. ์ค์น๊ฐ ์๋ฃ๋๋ฉด ์ฑ์ ๋ ๋ฒ ํด๋ฆญํ์ฌ Wine๊ณผ ํจ๊ป ์คํํ ์ ์์ต๋๋ค. ์ธ๊ธฐ ์๋ Windows ํ๋ก๊ทธ๋จ ๋ฐ ๊ฒ์์ ์ค์นํ๋ ๋ฐ ๋์์ด ๋๋ Wine์ ํตํ ๋ฉ์ง ์ธํฐํ์ด์ค์ธ PlayOnLinux๋ฅผ ์ฌ์ฉํด ๋ณผ ์๋ ์์ต๋๋ค.
Wine์ Linux์์ Windows ์ํํธ์จ์ด๋ฅผ ์คํํ๋ ๋ฐฉ๋ฒ์ด์ง๋ง Windows๊ฐ ํ์ํ์ง ์์ต๋๋ค. Wine์ ๋ชจ๋ Linux ๋ฐ์คํฌํ์์ ์ง์ Windows ํ๋ก๊ทธ๋จ์ ์คํํ ์ ์๋ ์คํ ์์ค Windows ํธํ์ฑ ๊ณ์ธต์ ๋๋ค. ๋ณธ์ง์ ์ผ๋ก Wine์ Windows๊ฐ ํ์ํ์ง ์๊ณ ๋ชจ๋ Windows ์์ฉ ํ๋ก๊ทธ๋จ์ ์คํํ ์ ์๋๋ก Windows๋ฅผ ์ฒ์๋ถํฐ ์ถฉ๋ถํ ๋ค์ ๊ตฌํํ๋ ค๊ณ ํฉ๋๋ค.
์คํฌ๋ฆฐ ์ท
Ad
์ค์จ๊ฑฐ-php
๊ธฐ์
์ด์ ์ Swagger๋ก ์๋ ค์ง OpenAPI ์ฌ์ ๋ฒ์ 3๊ณผ ํธํ๋ฉ๋๋ค. ํํธ์ ์ปจํ ์คํธ๊ฐ ์๋ ํฅ์๋ ์ค๋ฅ ๋ฉ์์ง. ์์ฑ ๋๋ ์ฃผ์์ ์ฌ์ฉํ์ฌ RESTful API์ ๋ํ OpenAPI ๋ฌธ์๋ฅผ ์์ฑํฉ๋๋ค. swagger-php๋ฅผ ์ฌ์ฉํ๋ฉด OpenAPI 3.0.0 ๋๋ OpenAPI 3.1.0์ ๋ํ ์ฌ์์ ์์ฑํ ์ ์์ต๋๋ค. ๊ธฐ๋ณธ์ ์ผ๋ก ์ฌ์์ ๋ฒ์ 3.0.0์ ๋๋ค. ๋ช ๋ น์ค ์ต์ ๋ฒ์ ์ ์ฌ์ฉํ์ฌ ์ด๋ฅผ 3.1.0์ผ๋ก ๋ณ๊ฒฝํ ์ ์์ต๋๋ค. ์ด๋์์๋ CLI๋ฅผ ์ฌ์ฉํ๋ ค๋ฉด swagger-php๋ฅผ ์ ์ญ์ผ๋ก ์ค์นํ๊ณ ์์คํ ์์ ๊ฐ๋ฐฉํ API ์คํ ํ์ผ์ ์ฐพ์ ์ ์๋๋ก ~/.composer/vendor/bin ๋๋ ํ ๋ฆฌ๋ฅผ PATH์ ๋ฐฐ์นํด์ผ ํฉ๋๋ค. ๊ฐ์ฒด๋ฅผ ํ๋ก๊ทธ๋๋ฐ ๋ฐฉ์์ผ๋ก ๋ ์ฝ๊ฒ ์กฐ์ํ ์ ์๋๋ก JSON ๋ฌธ์์ด์์ OpenApi ์ฃผ์ ๊ฐ์ฒด๋ฅผ ์์ฑํฉ๋๋ค. swagger ๋ฌธ์๋ฅผ ์ ์ JSON ํ์ผ๋ก ์์ฑํฉ๋๋ค.
๊ธฐ๋ฅ
- OpenAPI 3.0 ๋ฐ 3.1 ์ฌ์๊ณผ ํธํ ๊ฐ๋ฅ
- ์ฝ๋ ๋ฐ ๊ธฐ์กด phpdoc ์ฃผ์์์ ์ ๋ณด ์ถ์ถ
- ๋ช ๋ น์ค ์ธํฐํ์ด์ค ์ฌ์ฉ ๊ฐ๋ฅ
- ์์ ๊ฐ์ด๋๊ฐ ์๋ ์ค๋ช ์ ์ฌ์ดํธ
- ํ์ํ ์ค๋ฅ ๋ณด๊ณ (ํํธ, ์ปจํ ์คํธ ํฌํจ)
- PHP 8.1๋ถํฐ๋ ๋ชจ๋ ์ฃผ์์ PHP ์์ฑ์ผ๋ก๋ ์ฌ์ฉํ ์ ์์ต๋๋ค.
์นดํ ๊ณ ๋ฆฌ
์ด๊ฒ์ https://sourceforge.net/projects/swagger-php.mirror/์์๋ ๊ฐ์ ธ์ฌ ์ ์๋ ์ ํ๋ฆฌ์ผ์ด์ ์ ๋๋ค. ๋ฌด๋ฃ ์ด์ ์ฒด์ ์ค ํ๋์์ ๊ฐ์ฅ ์ฌ์ด ๋ฐฉ๋ฒ์ผ๋ก ์จ๋ผ์ธ์ผ๋ก ์คํํ๊ธฐ ์ํด OnWorks์์ ํธ์คํ ๋์์ต๋๋ค.