BRAMPP → Kurulum

Kurulum

60 saniyede çalışır hâlde

İndirin, sürükleyin, açın, sihirbazı çalıştırın. Bu sayfa her adımın ne yaptığını, uygulamanın gerçekten sizin indirdiğiniz şey olduğunu nasıl doğrulayacağınızı ve nadiren bir şey ters gittiğinde ne yapmanız gerektiğini anlatıyor.

Başlamadan önce

Gereksinimler

  • macOS 14 Sonoma veya üzeri. Uygulama, daha eski sürümlerde bulunmayan API'ler kullanıyor.
  • Apple Silicon. BRAMPP yerel bir arm64 derlemesi; yönettiği Homebrew servisleri de öyle.
  • Homebrew. Kurulu değilse sihirbaz kurmayı önerir — arkanızdan kendiliğinden kurmaz.
  • Yönetici hesabı. /etc/hosts düzenlemek, düşük portları dinlemek ve sistem güven deposuna sertifika otoritesi eklemek için gerekir. Her biri için, tam o anda, ayrı ayrı sorulur.

Disk alanının çoğu BRAMPP'a ait değil. Uygulamanın kendisi birkaç on megabayt. Yer kaplayan, onun üzerinden kurmayı seçtiğiniz ortam: Apache, PHP sürümleri, MariaDB ve gerisi diğer Homebrew paketleri gibi /opt/homebrew altında durur ve brew upgrade ile güncel kalır.

Kurulum

Dört adım

  1. İndirin ve sürükleyin. Releases sayfasından BRAMPP.dmg dosyasını alın ve BRAMPP.app'i Uygulamalar klasörüne sürükleyin. Bağlı disk imajından değil, Uygulamalar'dan çalıştırın — bazı macOS korumaları salt okunur bir birim içinde farklı davranır.
  2. Açın. Uygulama Developer ID ile imzalı ve noter onaylıdır; macOS onu fazladan bir adım gerektirmeden başlatır. Sağ tık → Aç yok, Gizlilik ve Güvenlik'e gitmek yok.
  3. Kurulum sihirbazını çalıştırın. Apache portları, PHP-FPM, mkcert sertifika otoritesi, localhost SSL, MariaDB root erişimi ve phpMyAdmin sırayla ele alınır — yalnızca onayladıklarınız kurulur ve çalıştırılan her komut konsola yazılır, yani okuyamayacağınız hiçbir şey olmaz.
  4. İlk alan adınızı oluşturun. + Yeni Alan Adı → ad ve platform seçin → https://projem.test adresini açın. Sanal sunucu, hosts kaydı, site klasörü, başlangıç projesi ve sertifika o âna kadar hazırdır.

Sıfırdan bir makinede uzun süren kısım sihirbazdır ve uzun sürmesinin sebebi çoğunlukla Homebrew'un indirme yapmasıdır. Sonrasındaki her şey saniyeler alır.

Güven

İmzalı — ve doğrulaması sizde

Bir indirmenin ne olduğuna dair sözüne inanmak zorunda değilsiniz. Nasıl denetleyeceğiniz aşağıda.

Her sürüm bir Developer ID Application sertifikasıyla imzalanır ve Apple'a gönderilir. Dönen bilet hem DMG'ye hem içindeki uygulamaya zımbalanır; ilk açılışınız ağsız gerçekleşiyorsa asıl önemli olan kısım budur — Gatekeeper zımbalanmış bileti çevrimdışı doğrulayabilir, zımbalanmamışı doğrulayamaz.

Kurduktan sonra kendiniz doğrulayın:

spctl -a -vvv -t exec /Applications/BRAMPP.app
# accepted
# source=Notarized Developer ID

Kimin, hangi takım kimliğiyle imzaladığını görmek için:

codesign -dv --verbose=4 /Applications/BRAMPP.app 2>&1 | grep -E 'Authority|TeamIdentifier'

Kaynaktan derlemek imzasız bir yerel derleme üretir. Bu beklenen davranıştır — kendi derlediğiniz bir uygulama hiçbir zaman karantinaya alınmaz, çünkü karantina bayrağını koyan indirme yolundan hiç geçmemiştir.

Alternatif

Kaynaktan derleme

Depo MIT lisanslıdır ve Xcode 15 veya üzeriyle derlenir:

git clone https://github.com/macitkaraca/brampp.git
cd brampp/macos
open BRAMPP.xcodeproj

BRAMPP şemasını seçip çalıştırın. Birim testler BRAMPP test hedefindedir ve ⌘U ile koşar — gerçek servislerinize dokunacak hiçbir şeyi değil, saf mantığı (sürüm karşılaştırma, yapılandırma ayrıştırma, bağımlılık sıralaması, yol doğrulama) sınarlar.

Sorun giderme

Bir şey ters gittiğinde

"BRAMPP açılamıyor"

Neredeyse her zaman eski bir indirmedir. İmzalama ve noter onayı belirli bir sürümle geldi; ondan önce kaydedilmiş bir DMG hâlâ Gatekeeper'a takılır. Uygulamalar'daki kopyayı silin, Çöp Kutusu'nu boşaltın ve Releases sayfasından güncel DMG'yi yeniden indirin. Sürerse, macOS'un tam olarak neye itiraz ettiğine bakın:

spctl -a -vvv -t exec /Applications/BRAMPP.app

Port zaten kullanımda

macOS kendi Apache'siyle gelir ve arada bir çalışır hâlde olur. BRAMPP yalnızca hata vermek yerine portun sahibini söyler; olağan çözüm sistem kopyasını durdurmaktır:

sudo launchctl unload -w /System/Library/LaunchDaemons/org.apache.httpd.plist

Yeni alan adı sunulmuyor

Bir alan adı web sunucusuna görünmez gibiyse, Servisler sekmesinden o servisi yeniden başlatın — güncel bir derlemede bu tekrarlıyorsa lütfen alan adının platformunu ve web sunucusunu belirterek bir issue açın; bu, etrafından dolaşmanız gereken bir durum değil, bir hatadır.

Tarayıcı hâlâ sertifikadan şikâyetçi

Sihirbazın mkcert adımını tamamladığından emin olun; otoritenin yalnızca üretilmiş olması yetmez, sistem güven deposunda bulunması gerekir. Yerel HTTPS rehberi neye bakacağınızı ve her şey doğruyken bile .local uzantısının neden başarısız olabileceğini anlatıyor.

SıradaBRAMPP neleri yönetiyor → AyrıcaRehberler →