cms-orbit / blog

4.3.1 2026-09-08 04:42 UTC

Requires

• php: ^8.4
• cms-orbit/core: ^4.6.1
• cms-orbit/saas: ^4.3.1
• laravel/framework: ^13.0
• tabuna/breadcrumbs: ^5.0

Requires (Dev)

• laravel/pint: ^1.30

proprietary

Published on Packagist.org on 2026-09-08 04:43 UTC

README

cms-orbit/blog는 cms-orbit/core와 cms-orbit/saas 위에 구축된 블로그 SaaS 컨테이너 패키지입니다.
포스트·카테고리·태그 관리, 10개 퍼블릭 테마, 인스턴스별 /admin SSO, 통합 Posting, 자동 프로비저닝, 데모 시딩을 제공합니다.

무엇을 제공하나요?

• container.json 기반 SaaS 컨테이너 — multi_database 격리, domain/subdomain/path 라우팅
• Blog Hub — 호스트 Orbit에서 인스턴스 목록·생성·Posting 통합 관리
• Posting / Sync — 여러 인스턴스의 글을 호스트에서 통합 조회·편집·인스턴스 간 복제
• 인스턴스 SSO Admin — signed URL로 인스턴스 /admin 진입 (포스트·카테고리·태그·테마 설정)
• 10개 퍼블릭 테마 — default, minimal, editorial, magazine, photo, dark, classic, corporate, playful, neon
• 퍼블릭 라우트 — /, /about, /posts/{slug}, /categories/{slug}, /feed (RSS)
• Public Hub — blog.{host}/ 컨테이너 도메인에서 인스턴스 목록·생성 CTA
• blog:seed-demos — 10개 데모 인스턴스 + 샘플 콘텐츠 시딩

요구사항

• PHP ^8.4
• cms-orbit/core ^4.5
• cms-orbit/saas ^4.2 — 유료 패키지, 사설 저장소에서만 배포
• Laravel ^13.0

설치

cms-orbit/blog는 cms-orbit/saas 위에서만 동작하고, saas 는 라이선스 키 기반 유료 패키지로 사설 저장소에서 배포됩니다. Packagist 에만 의존하면 cms-orbit/saas could not be found in any version 으로 설치가 실패합니다 — 정상 동작이며 패키지 오류가 아닙니다.

Composer 는 의존 패키지가 선언한 repositories 를 무시하고 루트 패키지의 것만 읽습니다. 따라서 구매 후 발급받은 저장소를 직접 composer.json에 추가해야 합니다.

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://<발급받은-사설-저장소-주소>"
        }
    ]
}

composer config --global --auth http-basic.<사설-저장소-호스트> <라이선스-키> <시크릿>
composer require cms-orbit/blog:^4.0
php artisan migrate
php artisan saas:route-cache build

cms-orbit/core(orbit:install)와 cms-orbit/saas가 먼저 설치·설정되어 있어야 합니다.

라이선스 구매·키 발급 문의: <판매 페이지 또는 연락처를 채워주세요>

Laravel Boost

이 패키지는 resources/boost/guidelines/blog.md, resources/boost/skills/blog-container-development/를 제공합니다.

• Boost 최초 설정: 호스트에서 php artisan boost:install 1회
• 이후: orbit:install / orbit:sync가 이 패키지를 Boost에 등록하고 boost:update 실행 (Boost가 이미 설정된 경우)

호스트 설정

작업	필수 여부	설명
composer require cms-orbit/blog + migrate	필수
php artisan saas:route-cache build	필수	컨테이너·엔드포인트 변경 후 재실행
container.json의 auto_provision.enabled	선택	true로 바꾸면 sync 시 blog.{host} 인스턴스 1회 생성
config/saas.php의 host_domains	운영 필수	SaaS 패키지 설정
호스트 routes/*.php 수동 편집	불필요	컨테이너 패키지가 라우트 제공

핵심 개념

Container

container/container.json이 블로그 앱 종류를 선언합니다.

• 격리 엔진 — multi_database (인스턴스별 DB)
• 라우팅 — domain, subdomain, path 지원 (path_first: true)
• 테마 — 인스턴스 생성 시 선택 가능 (theme_selectable: true)

자동 프로비저닝

instance.auto_provision으로 syncContainers() 시 기본 인스턴스를 1회 생성할 수 있습니다.

기본값은 enabled: false입니다. 사용하려면 container/container.json에서 enabled: true로 변경하세요.

"auto_provision": {
  "enabled": true,
  "name": "Blog",
  "subdomain": "blog",
  "theme": "default"
}

동일 서브도메인이 이미 있으면 skip하며, 생성 후 route cache를 rebuild합니다.

인스턴스 관리자 (SSO)

Blog Hub 또는 인스턴스 목록의 블로그 관리 링크 → signed URL → /admin/sso → /admin.

• TTL: admin.sso_ttl_minutes (기본 30분)
• 호스트 도메인에서 /admin 직접 접근은 404 (인스턴스 컨텍스트에서만 동작)

Posting (통합 글 관리)

호스트 Orbit Blog → Posting에서 모든 블로그 인스턴스의 글을 한곳에서 조회·편집할 수 있습니다.
PostSyncService로 인스턴스 간 포스트 복제도 지원합니다.

빠른 시작

1. 인스턴스 생성

php artisan saas:instance create blog "Demo Blog" --subdomain=demo --theme=magazine
php artisan saas:route-cache build

경로 기반 인스턴스:

php artisan saas:instance create blog "Docs Blog" --path=docs --theme=default

2. 데모 시딩

php artisan blog:seed-demos

호스트 앱에 Database\Seeders\DemoBlogInstancesSeeder가 있어야 합니다. 10개 테마별 데모 인스턴스와 샘플 콘텐츠를 생성합니다.

3. 인스턴스 관리자 접속

Orbit Blog Hub → 인스턴스 블로그 관리 링크 → SSO → /admin에서 포스트·카테고리·태그·테마 설정을 관리합니다.

설정 (config/blog.php)

키	ENV	기본값	설명
posts_per_page	—	12	퍼블릭 목록 페이지당 글 수
database.connection	BLOG_DB_CONNECTION / BLOG_DB_DRIVER	—	블로그 DB 연결 (미지정 시 SaaS 격리 엔진 사용)
sso.enabled	—	true	SSO 관리자 링크 활성화

관리자 화면

화면	라우트 이름	권한
Blog Hub	orbit.blog.index	blog.dashboard
인스턴스 목록	orbit.blog.instances.index	blog.dashboard
인스턴스 생성	orbit.blog.instances.create	blog.dashboard
인스턴스 상세	orbit.blog.instances.view	blog.dashboard
Posting 목록	orbit.blog.posting.index	blog.dashboard
Posting (인스턴스)	orbit.blog.posting.instance	blog.dashboard
Posting (글 상세)	orbit.blog.posting.posts.view	blog.dashboard
Posting (글 편집)	orbit.blog.posting.posts.edit	blog.dashboard

엔티티 CRUD(blog-posts, blog-categories, blog-tags)는 인스턴스 SSO Admin 또는 Posting에서 접근하며, blog.entities.{uriKey}.* 권한으로 제어됩니다.

퍼블릭 라우트 (인스턴스)

경로	설명
/	홈 (최근 글 목록)
/about	소개 페이지
/{slug}	글 상세
/categories/{slug}	카테고리별 목록
/feed	RSS 피드
/admin/sso	SSO 진입 (signed URL)
/admin	인스턴스 관리자 CRUD

Public Hub (컨테이너 도메인)

blog.{appHost}/ — 컨테이너 기본 서브도메인에서 인스턴스 목록과 생성 CTA를 제공합니다.

테마

slug	스타일
default	기본 블로그
minimal	미니멀
editorial	에디토리얼
magazine	매거진
photo	포토 중심
dark	다크 모드
classic	클래식
corporate	기업형
playful	캐주얼
neon	네온

테마는 container/themes/{slug}/ 아래 Blade 뷰 + Vite 빌드로 구성됩니다.

포함 리소스

• container/routes/instance.php — 퍼블릭·Admin 라우트
• container/routes/admin.php — SSO
• container/database/migrations/ — posts, categories, tags, blog_settings
• src/Provisioning/BlogDefaultInstanceProvisioner.php — 자동 프로비저닝
• src/Admin/SignedAdminUrlGenerator.php — SSO URL 생성
• src/Services/PostSyncService.php — 인스턴스 간 포스트 동기화

업데이트 노트

4.3.1

• tabuna/breadcrumbs ^5.0 을 명시 선언했습니다: BlogInstanceAdminRouteRegistrar 가 Tabuna\Breadcrumbs\Trail 을 타입으로 쓰는데 선언이 없어 cms-orbit/core 를 통한 전이 의존에 기대고 있었습니다.
• blog:seed-demos 가 실제로 동작합니다: DemoBlogInstancesSeeder 를 패키지 안(CmsOrbit\Blog\Database\Seeders)으로 옮겼습니다. 이전에는 호스트 네임스페이스(Database\Seeders)의 클래스를 참조하면서 패키지가 그 클래스를 제공하지도, 게시하지도 않았습니다. 즉 README 가 광고하는 이 명령이 모든 소비자에게 깨져 있었습니다. 시더는 CmsOrbit\Blog·CmsOrbit\Saas·Illuminate 만 참조하므로 호스트에 있을 이유가 없었습니다.

4.3.0

• cms-orbit/core ^4.5 → ^4.6: core 4.6.0 이 OrbitAccess 라우팅 리졸버와 여러 관리자 화면 수정(PostgreSQL 500, strict mode, orbit:install 의 OrbitProvider 미등록)을 담고 있습니다.
• cms-orbit/saas ^4.2 → ^4.3: saas 4.3.0 이 인스턴스별 관리자 콘솔과 마이그레이션 전 부팅 수정을 담고 있습니다.
• GitHub Actions 워크플로 추가: php 8.4·8.5 로 composer validate 와 pint --test 를 돌리는 ci.yml, 그리고 태그의 composer.json version 이 태그명과 일치하는지 확인하는 release-guard.yml. Packagist 는 불일치 태그를 조용히 무시합니다.
• CI 는 의존성을 설치하지 않고 포매터만 별도로 받아 검사합니다 — 이 패키지가 요구하는 cms-orbit/saas 는 유료·비공개 배포라 공개 러너에서 composer update 가 성립하지 않습니다.
• pint 포맷 정규화: pint --test 를 CI 게이트로 걸려면 기존 코드가 설정에 맞아야 해서 함께 정규화했습니다. 순수 포맷 변경이며 동작은 바뀌지 않습니다.

4.2.0

• laravel/framework ^11.0 || ^12.0 || ^13.0 → ^13.0: Laravel 13 전용으로 좁혔습니다.
• cms-orbit/core ^4.4 → ^4.5.
• cms-orbit/saas ^4.1 → ^4.2.
• 왜 좁혔나: Pest 5 를 채택한 4.4.0(패키지별 4.1.0)부터 pest-plugin-laravel 5 가 laravel/framework ^13.23 을 요구해, 이 저장소의 테스트가 Laravel 13 으로만 해석됩니다. 즉 Laravel 11·12 호환성을 더 이상 검증할 수 없는 상태로 그 범위를 광고하고 있었습니다. 검증되지 않는 지원 범위를 제약에 남겨두지 않기로 했습니다.
• Laravel 11·12 사용자는 업그레이드가 필요합니다. 이번 변경은 실제로 지원 구성을 제거하므로, php 하한 상향과 달리 소비자에게 직접 영향이 있습니다. Laravel 13 으로 올리거나 이전 버전에 머물러야 합니다.

4.1.0

• php 제약 ^8.3 → ^8.4: php 8.3 환경에서는 더 이상 설치되지 않습니다.
• cms-orbit/core ^4.1 → ^4.4.
• cms-orbit/saas ^4.0.8 → ^4.1.
• 생산 의존은 하나도 바뀌지 않았습니다. php 하한 상향으로 새로 받게 된 패키지는 Pest 5 계열(require-dev)뿐입니다. cms-orbit 전 패키지의 직접 의존 20개를 최신판과 전수 대조했고, 나머지 18개는 이미 php ^8.3 에서 최신을 받고 있었습니다. 이번 상향은 기능 확보가 아니라 장기 정리 목적입니다.
• 소비자의 Laravel 11·12 지원은 유지됩니다 (laravel/framework ^11.0 || ^12.0 || ^13.0).

4.0.7

• cms-orbit/saas 가 사설 저장소 유료 패키지임을 설치 안내에 명시: blog 는 Packagist 에 공개되어 있지만 saas 를 요구하므로 Packagist 단독으로는 설치되지 않습니다. saas 없이 blog 를 쓸 수 없음을 노출하는 의도된 전략입니다. 다만 문서가 composer require cms-orbit/blog:^4.0 만 안내해서, 실패 시 cms-orbit/saas could not be found in any version, there may be a typo in the package name 이라는 "패키지가 깨졌다"로 읽히는 메시지만 남았습니다. 사설 저장소 선언과 인증 설정 절차를 추가하고, 그 메시지가 정상 동작임을 명시했습니다.
• Composer 동작 주의: Composer 는 의존 패키지가 선언한 repositories 를 무시하고 루트 패키지의 것만 읽습니다. 따라서 구매자가 자기 composer.json 에 사설 저장소를 직접 추가해야 합니다.
• 요구사항의 낡은 버전 수정: cms-orbit/core 4.0.2 → ^4.1, cms-orbit/saas 4.0.3 → ^4.0.8.

4.0.6

• php 제약 ^8.3 복구: 게시된 태그는 모두 ^8.3 이었으나 main 에서 ^8.2 로 내려가 있었습니다. Laravel 13 은 php ^8.3 을 요구하므로 php ^8.2 + laravel/framework ^13 조합은 php 8.2 환경에서 조용히 Laravel 11 을 설치합니다.
• laravel/pint ^1.14 → ^1.30 (1.30 이 php ^8.3 을 요구).
• 릴리스 파이프라인 도입: .githooks/pre-push 가 composer.json 의 version 필드와 태그명이 어긋난 태그의 푸시를 차단합니다. cms-orbit/core 의 4.0.8 태그가 version: 4.0.7 로 만들어져 Packagist 가 아무 오류 없이 그 태그를 무시했고, 4.0.8 이 게시되지 않은 사실을 아무도 알지 못한 사고가 있었습니다. bin/release <버전> 이 version 갱신·검증·커밋·태그·푸시를 한 동작으로 묶어 이 드리프트를 원천 차단하고, cms-orbit/* 의존이 실제로 Packagist 에 게시되어 있는지 Composer 리졸버로 확인합니다. 저장소를 클론해 composer install 하면 core.hooksPath 가 자동 설정됩니다.

License

Proprietary