1.  [Strona główna](/)
2.  /
3.  [Baza wiedzy](/baza-wiedzy/)
4.  /
5.  Composer na hostingu 

1.  [Strona główna](/) ›
2.  [Baza wiedzy](/baza-wiedzy/) ›
3.  Composer na hostingu - zarządzanie zależnościami PHP

# Composer na hostingu - zarządzanie zależnościami PHP

Ostatnia aktualizacja: 8 kwietnia 2026

⚡ W skrócie · 9 min czytania

-   Jak używać Composer na hostingu PHP? Instalacja bez root, uruchomienie przez SSH, autoload, vendor/, wersje PHP. Composer na hostingu współdzielonym (LH.pl, CyberFolks, zenbox) i VPS.
-   Instalacja Composera na hostingu przez SSH.
-   Podstawowe komendy Composera.
-   .gitignore i vendor/ - dobre praktyki.
-   Wybór wersji PHP dla Composera.

**TL;DR:** Zainstaluj Composera przez SSH: `php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" && php composer-setup.php`. Wygeneruje `composer.phar`. Uruchamiaj przez `php composer.phar install`. Katalog `vendor/` dodaj do `.gitignore` - nigdy nie wgrywaj przez FTP.

## Instalacja Composera na hostingu przez SSH

Composer można zainstalować lokalnie w katalogu projektu - nie potrzebujesz uprawnień root. Wymaga PHP w wersji minimum 7.2.5 i dostępu SSH.

```
# Połącz się przez SSH z hostingiem
ssh user@twoj-hosting.pl

# Przejdź do katalogu projektu
cd ~/public_html/mojaplikacja

# Pobierz instalator Composera
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

# Zainstaluj (tworzy plik composer.phar)
php composer-setup.php

# Usuń instalator
php -r "unlink('composer-setup.php');"

# Sprawdź instalację
php composer.phar --version
```

Opcjonalnie - utwórz alias żeby wpisywać `composer` zamiast `php composer.phar`:

```
# Dodaj do ~/.bashrc
echo 'alias composer="php ~/public_html/composer.phar"' >> ~/.bashrc
source ~/.bashrc

# Teraz możesz używać:
composer install
```

## Podstawowe komendy Composera

`php composer.phar install`

Instaluje wszystkie zależności z `composer.lock` (jeśli istnieje) lub `composer.json`. Używaj na produkcji - gwarantuje te same wersje co w dev.

`php composer.phar install --no-dev --optimize-autoloader`

Instaluje bez pakietów developerskich (--no-dev) i optymalizuje autoloader (classmap zamiast PSR-4 scan) - szybszy autoloading na produkcji.

`php composer.phar require vendor/package:^1.0`

Dodaje nową zależność do `composer.json` i instaluje ją.

`php composer.phar update`

Aktualizuje zależności do najnowszych wersji zgodnych z `composer.json` i aktualizuje `composer.lock`. Uwaga: na produkcji używaj ostrożnie.

## .gitignore i vendor/ - dobre praktyki

Katalog `vendor/` należy zawsze umieścić w `.gitignore` - przechowuj tylko `composer.json` i `composer.lock`.

```
# Plik .gitignore
/vendor/
.env
.env.local
*.log
```

**Dlaczego nie wgrywać vendor/ przez FTP?** Laravel tworzy ~15,000 plików w vendor/. Wgrywanie przez FTP = kilka godzin + ryzyko błędów. Prawidłowy workflow: git push → SSH na serwerze → composer install (kilkadziesiąt sekund).

### Minimalna struktura pliku composer.json

```
{
  "name": "moja-firma/moja-strona",
  "require": {
    "php": "^8.1",
    "guzzlehttp/guzzle": "^7.0",
    "vlucas/phpdotenv": "^5.5"
  },
  "require-dev": {
    "phpunit/phpunit": "^10.0"
  },
  "autoload": {
    "psr-4": {
      "App\\": "src/"
    }
  }
}
```

## Wybór wersji PHP dla Composera

Composer używa domyślnej wersji PHP z PATH. Sprawdź i zmień na hostingu:

```
# Sprawdź aktualną wersję PHP
php -v

# Jeśli hosting ma wiele wersji PHP, możesz użyć konkretnej:
/usr/bin/php82 composer.phar install

# LH.pl - dostępne wersje przez which:
which php74 php80 php81 php82 php83
```

W pliku `.htaccess` możesz wybrać wersję PHP dla aplikacji webowej (np. PHP 8.2):

```
# .htaccess - wymuszenie PHP 8.2 (składnia zależna od hostingu)
AddType application/x-httpd-php82 .php
```

## Najczęstsze pytania

Czy Composer działa na hostingu współdzielonym? +

Tak - jeśli hosting oferuje dostęp SSH i PHP w wersji minimum 7.2.5 (Composer 2 wymaga PHP 7.2.5+). Większość polskich hostingów współdzielonych ([LH.pl](/out/lh-pl/#reklama "LH.pl"), [CyberFolks](/out/cyberfolks/#reklama "CyberFolks"), [Zenbox](/out/zenbox/#reklama "Zenbox"), [home.pl](/out/home-pl/#reklama "home.pl")) oferuje SSH i PHP 8.x. Zainstaluj Composera lokalnie w katalogu projektu przez SSH: `php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" && php composer-setup.php && php -r "unlink('composer-setup.php');"`

Dlaczego nie powinienem wgrywać katalogu vendor/ przez FTP? +

Katalog vendor/ może zawierać dziesiątki tysięcy plików (np. Laravel ma 15k+ plików w vendor/). Wgrywanie przez FTP zajmie godziny. Prawidłowy workflow: dodaj vendor/ do .gitignore, trzymaj tylko composer.json i composer.lock w repozytorium, uruchom composer install przez SSH na serwerze. Wyjątek: jeśli hosting nie ma SSH i nie możesz uruchomić Composera, musisz wgrać vendor/ - ale to ostateczność.

Jak wybrać wersję PHP dla Composera na hostingu? +

Na hostingach z MultiPHP ([LH.pl](/out/lh-pl/#reklama "LH.pl"), [CyberFolks](/out/cyberfolks/#reklama "CyberFolks"), [home.pl](/out/home-pl/#reklama "home.pl")) możesz zmienić wersję PHP per katalog przez plik .htaccess: `AddType application/x-httpd-php82 .php` (dla PHP 8.2) lub przez panel cPanel → MultiPHP Manager. Composer wymaga PHP 7.2.5+; Composer install używa wersji PHP z PATH - sprawdź przez ssh: `php -v`. Na DirectAdmin zmień wersję PHP przez Extra Features → PHP Version.

Jak zautomatyzować composer install po deployu przez GitHub Actions? +

W workflow GitHub Actions dodaj krok: uses: php-actions/composer@v6 z with: command: install, php\_version: "8.2", args: --no-dev --optimize-autoloader. Alternatywnie: jeśli deployjujesz przez SSH, dodaj krok ssh po deployu plików: cd /var/www/myapp && php composer.phar install --no-dev --optimize-autoloader. Flagi --no-dev (bez zależności developerskich) i --optimize-autoloader (classmap zamiast autoloading z pliku) są kluczowe na produkcji.

## Szybkie przejście do ofert związanych z tym tematem

Wybraliśmy oferty i strony z kodami rabatowymi, które najczęściej pasują do tego scenariusza użycia.

LH.pl

Dobre zaplecze pod PHP, Composer i typowe frameworki.

PHP

[Aktywuj rabat →](/out/lh-pl/#reklama "LH.pl")

#Reklama · link partnerski

[Zobacz kod rabatowy →](/kody-rabatowe/lh-pl/)

CyberFolks

Hosting z szybkim startem pod aplikacje PHP.

Aplikacje

[Aktywuj rabat →](/out/cyberfolks/#reklama "CyberFolks")

#Reklama · link partnerski

[Zobacz kod rabatowy →](/kody-rabatowe/cyberfolks/)

Zenbox

Prosty shared hosting dla mniej złożonych projektów.

Shared

[Aktywuj rabat →](/out/zenbox/#reklama "Zenbox")

#Reklama · link partnerski

[Zobacz kod rabatowy →](/kody-rabatowe/zenbox/)

## Powiązane strony

-   [PHP-FPM - konfiguracja i optymalizacja](/baza-wiedzy/php-fpm-konfiguracja-optymalizacja/)
-   [Wersje PHP na hostingu - co wybrać?](/baza-wiedzy/php-wersje-hosting-co-wybrac/)
-   [Deploy przez Git na hostingu](/baza-wiedzy/git-deploy-hosting/)
-   [Laravel na hostingu](/baza-wiedzy/laravel-na-hostingu/)
-   [Porównanie hostingów z SSH](/hosting/)
-   [Baza wiedzy](/baza-wiedzy/)
-   [Jak wybrać hosting?](/jaki-hosting-wybrac/)

Autor: [Redakcja HostGrade.pl](/autorzy/) Zespół redakcyjny · Aktualizacja: 8 kwietnia 2026

Artykuły HostGrade.pl przygotowuje i aktualizuje redakcja serwisu. Ceny startowe, ceny odnowienia i warunki planów sprawdzamy w cennikach i regulaminach dostawców, a potem liczymy całkowity koszt za 2 lata (cena startowa plus odnowienia). Zasady zbierania danych i liczenia kosztów opisujemy na stronie Metodologia. Linki partnerskie oznaczamy jako #reklama.

[O redakcji i metodologii →](/autorzy/)