Skip to content
Open
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
115 changes: 115 additions & 0 deletions 4-Intermediário/10-Encapsulamento.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,115 @@
# 4.6 - Encapsulamento

## O que é?

Encapsulamento é o conceito de **proteger os dados de uma classe**, controlando como eles são acessados e modificados.

Ou seja:
Você **esconde os atributos** e permite acesso apenas através de métodos.

---

## Por que usar?

Para garantir que os dados:

* Não sejam alterados de forma errada
* Tenham regras de validação
* Fiquem mais seguros

---

## Ideia simples

Pensa em uma conta bancária:

* Você não altera o saldo direto ❌
* Você usa métodos como `depositar()` ou `sacar()` ✔️

> Isso é encapsulamento.

---

## Exemplo sem encapsulamento (errado)

```php
<?php

class ContaBancaria {
public $saldo = 1000;
}

$conta = new ContaBancaria();
$conta->saldo = -5000; // ❌ valor inválido
```

---

## Exemplo com encapsulamento (correto)

```php
<?php

class ContaBancaria {

private $saldo = 1000;

public function depositar($valor)
{
if ($valor > 0) {
$this->saldo += $valor;
}
}

public function sacar($valor)
{
if ($valor > 0 && $valor <= $this->saldo) {
$this->saldo -= $valor;
}
}

public function getSaldo()
{
return $this->saldo;
}

}

$conta = new ContaBancaria();
$conta->depositar(500);
$conta->sacar(200);

echo $conta->getSaldo(); // 1300
```

---

## O que está acontecendo?

* `saldo` é **private** → não pode ser acessado diretamente
* Só pode ser alterado por métodos controlados
* Existem regras (`if`) para evitar erros

---

## Resumão

* Encapsular = **esconder os dados**
* Acesso só por métodos (getters/setters)
* Mais segurança e controle

---

## 🧩 Frase pra guardar

> **Encapsulamento é proteger os dados e controlar como eles são acessados.**

---

## 🔗 Relação com outros conceitos

* Usa `private` e `protected` (modificadores de acesso)
* Trabalha junto com getters e setters
* Base para código seguro e profissional

---
171 changes: 171 additions & 0 deletions 4-Intermediário/9-Polimorfismo.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,171 @@
# 4.5 - Polimorfismo

## O que é?

Polimorfismo é a capacidade de um mesmo método ter **comportamentos diferentes**, dependendo da classe que o implementa.

> Ou seja:
Você chama **o mesmo método**, mas o resultado muda.

---

## Por que usar?

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Padronize os headings ATX para remover espaço duplo após ##.

As linhas 12, 33 e 82 violam a regra MD019 (no-multiple-space-atx).

💡 Ajuste sugerido
-##  Por que usar?
+## Por que usar?

-##  Exemplo prático
+## Exemplo prático

-##  Outro exemplo (mais real)
+## Outro exemplo (mais real)

Also applies to: 33-33, 82-82

🧰 Tools
🪛 markdownlint-cli2 (0.21.0)

[warning] 12-12: Multiple spaces after hash on atx style heading

(MD019, no-multiple-space-atx)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@4-Intermediário/9-Polimorfismo.md` at line 12, Headings use double spaces
after the ATX marker causing MD019 violations; locate the headings like "##  Por
que usar?" (and the other ATX headings at the same file that have two spaces
after the hashes) and remove the extra space so they read "## Por que usar?"
(and similarly for the other headings) to conform to the no-multiple-space-atx
rule.


Para evitar vários `if/else` e deixar o código:

* Mais organizado
* Mais fácil de manter
* Mais profissional

---

## Ideia simples !

Você tem um método chamado `emitirSom()`:

* Cachorro → **Au au**
* Gato → **Miau**

> Mesmo método, comportamentos diferentes.

---

## Exemplo prático

```php
<?php

class Animal {

public function emitirSom()
{
echo "Som genérico";
}

}

class Cachorro extends Animal {

public function emitirSom()
{
echo "Au au";
}

}

class Gato extends Animal {

public function emitirSom()
{
echo "Miau";
}

}
```

---

## Utilizando

```php
<?php

$animal1 = new Cachorro();
$animal2 = new Gato();

$animal1->emitirSom() . PHP_EOL; // Au au
$animal2->emitirSom() . PHP_EOL; // Miau

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Verifica ocorrências do padrão que não imprime newline
rg -nP '\->\w+\(.*\)\s*\.\s*PHP_EOL;' --type md

Repository: danielhe4rt/php4noobs

Length of output: 580


Corrigir exemplo de saída: concatenação com PHP_EOL não imprime nada sozinha.

Nas linhas 76-77 e 126, a expressão ... . PHP_EOL; é descartada—ela não gera quebra de linha no output. Isso é confuso para quem está aprendendo.

Sugestão de ajuste (linhas 76-77)
-$animal1->emitirSom() . PHP_EOL; // Au au
-$animal2->emitirSom() . PHP_EOL; // Miau
+echo $animal1->emitirSom() . PHP_EOL; // Au au
+echo $animal2->emitirSom() . PHP_EOL; // Miau
Sugestão de ajuste (linhas 125-127)
 foreach ($pagamentos as $pagamento) {
-    $pagamento->pagar(100) . PHP_EOL;
+    echo $pagamento->pagar(100) . PHP_EOL;
 }
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
$animal1->emitirSom() . PHP_EOL; // Au au
$animal2->emitirSom() . PHP_EOL; // Miau
echo $animal1->emitirSom() . PHP_EOL; // Au au
echo $animal2->emitirSom() . PHP_EOL; // Miau
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@4-Intermediário/9-Polimorfismo.md` around lines 76 - 77, The examples
currently concatenate PHP_EOL but do not output it because the expressions are
not echoed; replace the discarded expressions with proper echo (or print)
statements so the newline prints, e.g. use echo $animal1->emitirSom() . PHP_EOL;
and echo $animal2->emitirSom() . PHP_EOL; and likewise change the expressions
around the other example (the block around lines 125-127) to echo the
emitirSom() results with PHP_EOL so the expected line breaks appear.

```

---

## Outro exemplo (mais real)

```php
<?php

class Pagamento {

public function pagar($valor)
{
echo "Pagamento genérico de R$ $valor";
}

}

class Pix extends Pagamento {

public function pagar($valor)
{
echo "Pagamento via PIX de R$ $valor";
}

}

class Cartao extends Pagamento {

public function pagar($valor)
{
echo "Pagamento no cartão de R$ $valor";
}

}
```

### Usando:

```php
<?php

$pagamentos = [
new Pix(),
new Cartao()
];

foreach ($pagamentos as $pagamento) {
$pagamento->pagar(100) . PHP_EOL;
}
```

---

## Sem polimorfismo

```php
if ($tipo == 'pix') {
echo "Pagamento via PIX";
} elseif ($tipo == 'cartao') {
echo "Pagamento no cartão";
}
```

❌ Difícil de manter
❌ Cresce rápido demais

---

## Com polimorfismo

```php
$pagamento->pagar(100);
```

✔️ Limpo
✔️ Reutilizável
✔️ Escalável

---

## Resumão !!!

* Mesmo método (`pagar`, `emitirSom`)
* Classes diferentes
* Resultados diferentes

---

## 🧩 Frase pra guardar

> **Polimorfismo é usar o mesmo método com comportamentos diferentes em objetos diferentes.**

---