(처음) Laravel 설치

때때로, 특히 경력을 시작하는 단계에서는 지침을 따르지만 아무것도 얻지 못하는 것처럼 보일 수 있지만 다른 사람들은 이를 매우 쉽게 생각하는 것 같습니다.

매우 실망스러울 수 있는데, 수십년이 지난 후에도 제가 똑같은 일을 경험하는 몇 가지 사례를 설명하고 싶습니다. 그래서 저는 일을 제대로 진행하기 위해 제가 겪은 실수와 우여곡절을 자세히 설명하려고 노력하고 있습니다. 이 주제에 대한 첫 번째 게시물이지만 더 많은 게시물을 작성하고 싶습니다.

라라벨을 배워봅시다.

Laravel은 놀라운 개발자 경험을 제공하기 위해 노력하고 있습니다. [...]
PHP 웹 프레임워크를 처음 접하거나 수년간의 경험을 갖고 있는지 여부 [...]

Laravel은 다른 프레임워크보다 더 기본적이고 단순하면서도 엄격한 아키텍처 결정이 필요하기 때문에 적어도 PHP 업계에서는 "개발자 프레임워크"로 평가됩니다. 저는 몇 가지 다른 PHP 프레임워크인 Drupal 7을 수행했습니다. , Drupal 8 , Symfony, WordPress, Concrete5, PrestaShop, CodeIgniter가 내 머릿속에 떠오릅니다. 따라서 이 내용은 다루지 않겠습니다. 준비되지 않았습니다.

베어본 노트북부터 시작해 어디까지 갈 수 있는지 확인해 보겠습니다.

필수 구성 요소 설치(tldr; 문제: 0, 신뢰도: 최고)

첫 번째 Laravel 애플리케이션을 만들기 전에 로컬 컴퓨터에 PHP, Composer 및 Laravel 설치 프로그램이 설치되어 있는지 확인하세요. 또한 애플리케이션의 프런트엔드 자산을 컴파일할 수 있도록 Node와 NPM 또는 Bun을 설치해야 합니다.

알겠습니다. 문제 없습니다. 나는 그 PHP 중 일부를 직접 설치하고 getcomposer.org에서 작곡가를 구한 다음 "Laravel 설치 프로그램"을 설치하는 방법을 알아낼 것입니다. 분명히 내 배포판에는 기본적으로 Node 22가 있거나 이전에 다른 것을 설정할 때 설치되었으므로 이 내용이 포함되어야 합니다.

$ 작곡가 글로벌에는 laravel/설치 프로그램이 필요합니다

붐. 완료. 아직 문제는 없습니다. 좋은 출발을 하고 있으며 자신감은 사상 최고입니다.

새로운 Laravel 프로젝트 설정(tldr; 문제: 일부, 신뢰도: 높음)

$ laravel 새로운 예제 앱
zsh: 명령을 찾을 수 없습니다: laravel

아. 아마도 그 최고 자신감에 대해 다시 생각해 봐야 할 것 같습니다.

그래서 Composer는 일반 바이너리 경로에 아무 것도 설치하지 않고 Composer 설치 프로그램도 시스템 경로에 자신을 추가하기 위해 아무 것도 하지 않는 것 같습니다. 저는 작곡가가 설치한 바이너리가 어떤 경로에 나타나든 직접 실행했기 때문에 그런 일을 실제로 겪은 적이 없습니다. 예를 들어 Drupal의 경우 다음 항목에 따라 Vendor/drush/drush/drush 또는 Vendor/bin/drush가 있습니다. 실행중인 버전. 나 자신에게 심볼릭 링크나 별칭을 추가해야 합니까, 아니면 작곡가가 "전역적으로" 추가한 곳마다 laravel 바이너리를 찾아야 합니까?

모르겠어요 이건 검색해봐야겠네요

스택 오버플로 답변에서 몇 가지 단서를 찾았습니다. Composer global config bin-dir --absolute를 사용하여 Composer 바이너리 디렉토리를 찾을 수 있으며, 최신 버전의 Composer에서는 실행 가능한 명령이 포함된 모든 항목이 해당 디렉토리에 배치되는 것으로 보입니다. 위계질서에 자신을 지는 것보다.

좋아요. 시작 스크립트에 뭔가를 추가하여 경로에 넣을 수 있습니다... 단, 해당 명령은 경로 이상의 것을 생성합니다...

$ 작곡가 전역 구성 bin-dir --absolute
현재 디렉토리를 /home/moopet/.config/composer
로 변경했습니다. /home/moopet/.config/composer/vendor/bin

... 그리고 그 전체 문자열을 디렉토리로 사용할 수 없습니다. 아마도 마지막 줄이나 다른 것을 얻으려면 tail을 사용해야 할 것입니다. 잠깐, 아니 --quiet 플래그를 포함하는 이 SO 답변에 대한 또 다른 설명이 있습니다. 그게 무슨 역할을 하나요? 작곡가 --help를 사용해 보겠습니다:

사용법:
목록 [옵션] [--] [<네임스페이스>]

글쎄, 어, 기본 Composer 명령에서 --help를 실행하면 실제로는 Composer 자체가 아닌 list 하위 명령에 대한 도움말이 제공된다는 사실이 밝혀졌습니다. 그 때문에 잠시 당황했습니다.

-q --quiet 메시지를 출력하지 않습니다

흠, 그건 별로 쓸모가 없을 것 같네요! 우리는 약간의 결과를 원합니다. 또 뭐가 있나요?

--raw 원시 명령 목록을 출력합니다
--format=FORMAT 출력 형식(txt, xml, json 또는 md) [기본값: "txt"]

아마도 이것들 중 하나겠죠?

"--raw" 옵션이 존재하지 않습니다.
"--format" 옵션이 존재하지 않습니다.

아니요. 생각했던 것처럼 일반 사용 플래그가 아닌 나열 옵션입니다.

어차피 똥과 재미를 위해 --quiet을 사용하여 실행해 보겠습니다.

$ 작곡가 전역 구성 bin-dir --absolute --quiet
/home/moopet/.config/composer/vendor/bin

글쎄, 효과가 있었다는 걸 알아요. 단지 문서화가 잘못되어 있을 뿐입니다.

약간의 보호 코드를 사용하여 이를 쉘 시작 스크립트에 추가하고 계속할 수 있습니다.

if command -v composer >/dev/null; then
  export PATH=$(composer global config bin-dir --absolute --quiet):$PATH
fi

새로운 Laravel 프로젝트 설정, 2번(tldr; 문제: 일부, 자신감: 흔들림)

이번에는 laravel의 새로운 example-app이 출시되고 몇 가지 사항을 묻는 메시지가 표시됩니다. 나는 스타터 키트를 제외하고 차이점을 알기 위해 문서를 충분히 읽지 않았기 때문에 기본값을 수락합니다. 문서에 그렇게 나와 있기 때문에 "Breeze"를 선택했습니다.

설치 프로세스가 시작되고 다음이 나타날 때까지 모든 것이 괜찮아 보입니다.

- 루트 작곡가.json에는 laravel/pint ^1.0이 필요합니다. -> laravel/pint[v1.0.0, v1.1.0, v1.1.1]로 만족됩니다.
- laravel/pint[v1.0.0, ..., v1.1.1]에는 ext-xml이 필요합니다. * -> 귀하의 시스템에서 누락되었습니다. PHP의 xml 확장을 설치하거나 활성화하세요.

잠깐, PHP에 XML 확장이 필요합니까? 그것은 요구 사항으로 나열되지 않았습니다! 좋아요, php-xml을 빠르게 적절하게 설치하겠습니다.

좋습니다. 모두 설치되었습니다. 다시 설정을 실행해보겠습니다.

laravel의 새로운 예제 앱
NewCommand.php 라인 789:
이미 존재하는 애플리케이션입니다!

아.

그래서 설치 프로그램이 부분적으로 진행되었고 종속성을 확인하지 않았기 때문에 실패했으며 앱이 손상된 상태로 남아 있었습니다. 그것은 좋은 징조가 아닙니다. Laravel이 버전 11을 사용하고 있나요?

물론 지금쯤 기본적인 사전 요구 사항을 확인했을까요? 아 글쎄. rm -r example-app을 실행하고 다시 시작하겠습니다. 아직 시작하지 않았기 때문에 손실된 것은 없습니다.

간단히 말하면¹ 다음으로 누락된 종속성은 DOM 확장이거나 XML 확장이었습니다. 아니면 cURL 확장자일 수도 있습니다.

- phpunit/phpunit[11.0.1, ..., 11.4.3] require ext-dom * -> 귀하의 시스템에서 누락되었습니다. PHP의 dom 확장을 설치하거나 활성화하세요.
- 루트 작곡가.json에는 phpunit/phpunit ^11.0.1이 필요합니다. -> phpunit/phpunit[11.0.1, ..., 11.4.3]으로 만족됩니다.

그러면 php-dom을 설치해야 하나요? 아니요. 다른 것을 시도해 보세요. 다시 스택 오버플로. php-curl을 설치해야 하는 것으로 나타났습니다. 힘내세요.

앞으로. rm -r 디렉토리를 입력하고 설정 마법사를 다시 실행하세요.

새로운 Laravel 프로젝트 설정, 3개를 선택하세요(tldr; 문제: hngg, 자신감: 여전히 흔들리지만 최근 문제 해결 성공으로 인해 강화됨)

어떤 데이터베이스 서버를 사용할 것인지 묻는 메시지가 나타납니다. 다들 옆에 "PDO 확장 없음"이라고 뜹니다.

한숨.

설치 프로그램을 종료하고 전체 디렉토리를 다시 삭제하고 php8.3-mysql을 적절하게 설치합니다. 직접적인 php-pdo 패키지도 없고 작동하는 php-mysql에 대한 별칭도 없기 때문에 귀찮은 작업을 수행했습니다. 검색 중입니다.

IlluminateDatabaseQueryException
SQLSTATE[HY000] [2002] 연결이 거부됨(연결: mysql, SQL: 선택이 있음(information_schema.tables에서 1 선택, 여기서 table_schema = 'laravel_example_app' 및 table_name = 'migrations' 및 table_type in ('BASE TABLE', 'SYSTEM VERSIONED') )) '존재'로)

이제 뭐죠? 이 설치 프로그램은 나에게 데이터베이스 연결 세부 정보를 요청한 적이 없습니다. 그리고 뭔가에 대해 SQL 명령을 실행하려고 합니다. 누가 알겠어요?

공교롭게도 저는 LAN의 다른 호스트에서 MySQL 서버를 실행하고 있으며 이를 사용할 준비가 되어 있었습니다(비록 자체 데이터베이스를 가져오는 것이 Laravel의 요구 사항으로 나열되지는 않았지만). SQLite를 설치했어야 했는데 자격 증명이 필요하지 않기 때문에 작동했을 수도 있습니다.

sudo apt install php8.3-sqlite

다시 시도해 보세요.

rm -r 예제-앱
laravel 새로운 예제 앱
...

대성공. 해커의 목소리 "I'm in". 승리를 위해. 성공아.

결론

내가 해냈다고? 그런 것 같아요.

그러나 누군가 나에게 이 작업에 시간이 얼마나 걸릴지 묻는다면 열정적인 문서화와 평판을 바탕으로 저는 20분이라고 대답했을 것입니다. 제가 업무상 이 작업을 수행했다면 프로젝트 관리자는 개발자 견적 경험을 바탕으로 그 금액을 두 배, 네 배로 늘렸을 것입니다.

정말로 얼마나 걸렸나요? 어느 날 저녁에는 한 시간 정도, 그 다음날에는 한 시간 정도. 서두르지는 않았지만 간단하지는 않았습니다.

그거 알아요? 불만족스럽습니다. 설치 프로그램의 해당 부분이 완전히 손상된 것처럼 보이기 때문에 MySQL을 사용하지 않습니다. 저는 SQLite를 사용하고 있는데 이는 실제 프로덕션 환경에서 진행되는 것보다 한 단계 더 발전한 것입니다. 따라서 실제 튜토리얼을 시작하기 전에 TODO 목록에 몇 가지 항목이 남아 있습니다.

하지만 실행됩니다. 빌드 단계에서는 문제 없이 진행되었다고 주장합니다.

다음 단계를 진행할 준비가 되었습니다. 브라우저에서 데모 페이지를 열자마자 콘솔에 나타나는 JsonException, 구문 오류 및 ProcessTimedOutException을 수정합니다.

아아.

만약 일이 잘 풀렸으면 어.

---

1. 후렴: 너무 늦었어요 ↩

위 내용은 (처음) Laravel 설치의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!