> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Laravel Console Starter

> artisan 명령어를 메인으로 하는 Laravel 스타터 키트. GitHub Actions에서 스케줄 실행하고, 알림으로 아웃풋을 전송합니다.

## 개요

[laravel-console-starter](https://github.com/invokable/laravel-console-starter)는 커스텀 artisan 명령어를 중심으로 하는 Laravel 애플리케이션 개발을 가속하는 스타터 키트입니다.

스탠드얼론 CLI 툴을 만드는 것이 아니라, Laravel 프레임워크의 에코시스템 전체(의존성 주입·알림·스케줄링·테스트)를 활용한 콘솔 애플리케이션을 빠르게 구축할 수 있습니다. GitHub Actions에서 스케줄 실행하고, 결과를 메일이나 Slack 등의 알림으로 전송하는 워크플로가 기본적인 사용 사례입니다.

## 요구 사항

* PHP `^8.3`
* Laravel Framework `^13.0`
* Laravel Installer `^5.24`

## 설치

```bash theme={null}
laravel new --using=revolution/laravel-console-starter --no-interaction my-app
```

설치 후의 주요 디렉터리 구조:

```
my-app/
├── app/Console/Commands/   # 커스텀 artisan 명령어 배치
├── .github/workflows/
│   └── cron.yml            # GitHub Actions 스케줄 예시
├── config/                 # 애플리케이션 설정
└── routes/console.php      # 명령어 등록
```

## 주요 특징

<Columns cols={3}>
  <Card title="콘솔 앱 특화" icon="terminal">
    Web용 오버헤드를 배제하고 artisan 명령어 개발에 집중할 수 있는 구성입니다.
  </Card>

  <Card title="GitHub Actions 스케줄링" icon="clock">
    서버 cron 잡이 불필요. `.github/workflows/cron.yml`의 설정 예시가 처음부터 포함되어 있습니다.
  </Card>

  <Card title="Laravel 에코시스템 활용" icon="layers">
    알림·HTTP 클라이언트·테스트·DI 컨테이너 등 Laravel의 풍부한 기능을 그대로 사용할 수 있습니다.
  </Card>
</Columns>

## 퀵 스타트

### 명령어 만들기

```bash theme={null}
php artisan make:command Hello --command=hello
```

`app/Console/Commands/Hello.php`가 생성됩니다. `handle()` 메서드에 로직을 구현하고, 명령어를 실행합니다.

```bash theme={null}
php artisan hello
```

### GitHub Actions로 스케줄 실행

`.github/workflows/cron.yml`을 편집하여 실행할 명령어와 스케줄을 설정합니다.

```yaml theme={null}
on:
  schedule:
    - cron: '0 0 * * *'  # 매일 UTC 오전 0시

jobs:
  cron:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: shivammathur/setup-php@v2
        with:
          php-version: 8.5
      - run: composer install --no-dev -q
      - run: cp .env.example .env
      - run: php artisan key:generate
      - run: php artisan your:command
```

### 알림 전송

명령어의 실행 결과를 알림으로 보내려면, `make:notification`으로 클래스를 만들고 `Notification` 파사드로 전송합니다.

```bash theme={null}
php artisan make:notification TaskCompleted
```

```php theme={null}
Notification::route('mail', 'admin@example.com')
    ->notify(new TaskCompleted('처리가 완료되었습니다'));
```

<Tip>
  알림 채널(메일·Slack 등)의 설정이 필요한 경우에는 `php artisan config:publish mail`이나 `php artisan config:publish services`로 설정 파일을 공개하세요.
</Tip>

## 애플리케이션 아이디어

이 스타터 키트로 구축할 수 있는 애플리케이션 아이디어입니다.

<AccordionGroup>
  <Accordion title="모니터링·분석">
    * 웹사이트 헬스 체크와 Slack 알림
    * 서버 리소스 사용 현황 리포트를 메일 전송
    * SSL 인증서 만료일 확인과 알림
    * API 응답 시간 모니터링과 알림
    * 경쟁사 가격 변동 추적과 Discord 알림
  </Accordion>

  <Accordion title="재무·비즈니스">
    * Google AdSense 수익을 메일로 전송
    * AWS 비용을 Discord로 알림
    * 일일 암호 자산 포트폴리오 업데이트를 Discord로
    * 주가 알림을 Slack 채널로
    * 청구서 지불 기한 리마인더
    * 월간 경비 리포트 생성과 배포
  </Accordion>

  <Accordion title="데이터 처리·리포트">
    * 오래된 로그 파일 정리와 스토리지 리포트
    * 서로 다른 API 간 데이터 동기화와 결과 알림
    * CSV 데이터 임포트와 처리 결과 알림
    * 정기적인 데이터 익스포트와 클라우드 스토리지 업로드
  </Accordion>

  <Accordion title="콘텐츠·마케팅">
    * 웹사이트의 링크 끊김 확인과 리포트
    * SEO 키워드 랭킹 모니터링과 변동 알림
    * 블로그 게시글 퍼포먼스 지표 주간 리포트
    * RSS 피드의 콘텐츠 집계와 알림
  </Accordion>

  <Accordion title="개발·DevOps">
    * GitHub 저장소의 의존성 보안 알림
    * 코드베이스의 정적 분석 리포트
    * 배포 후의 애플리케이션 헬스 체크
    * API 문서 변경 감지와 알림
  </Accordion>

  <Accordion title="AI·기타">
    * [laravel-copilot-sdk](https://github.com/invokable/laravel-copilot-sdk)를 사용한 AI 에이전트 툴
    * [laravel/mcp](https://github.com/laravel/mcp) 패키지를 사용한 로컬 MCP 서버
    * 도메인 만료일 모니터링과 알림
    * Google Trends 키워드 모니터링과 알림
    * 개인 지출 카테고리 인사이트 리포트
  </Accordion>
</AccordionGroup>

## 문서

<Columns cols={2}>
  <Card title="튜토리얼" href="/ko/packages/laravel-console-starter/tutorial" icon="book-open">
    설치부터 명령어 작성, GitHub Actions에서의 스케줄링, 알림 전송, 실전 앱 예시까지.
  </Card>
</Columns>

## 참고 링크

* GitHub: [invokable/laravel-console-starter](https://github.com/invokable/laravel-console-starter)
* DeepWiki: [invokable/laravel-console-starter](https://deepwiki.com/invokable/laravel-console-starter)


## Related topics

- [튜토리얼 - Laravel Console Starter](/ko/packages/laravel-console-starter/tutorial.md)
- [Laravel 스타터 킷 만드는 법](/ko/advanced/starter-kit-creation.md)
- [Laravel 11 이후의 애플리케이션 구조](/ko/advanced/app-structure.md)
- [Laravel 11 이후의 새 앱 구조 FAQ](/ko/advanced/app-structure-faq.md)
- [Laravel Cloud — Laravel 전용 PaaS의 전모](/ko/blog/laravel-cloud.md)